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PREFACE 



This manual is a reference for the programmer with some knowledge of 
assemblers and assembly languages. 

Using the MACRO assembler effectively involves using other 
DECsystem-10 facilities: the monitor (TOPS-10) , the LINK program, the 
CREF program, a debugging program, a text editor (SOS or TECO), and 
machine language. Therefore the following DECsystem-10 documents will 
prove useful : 

Operating System Commands 
AA-0916C-TB 

Monitor Calls 

AA-0974C-TB 

LINK Reference Manual 
AA-0988C-TB 

SOS User 's Guide 

DEC-10-USOSA-A-D 

Introduction to TECO 
DEC-10-UTECA-A-D 

DDT Dynamic Debugging Techique 
DEC-10-UDDTA-A-D 

GALAXY Batch Reference Manual 
DEC-10-OGBRA-A-DN1 

Hardware Reference Manual 
EK-10/20-HR-001 



IX 



CHAPTER 1 
INTRODUCTION TO MACRO 



MACRO is the symbolic assembler program for the DECsystem-10 . The 
assembler reads a file of MACRO statements and composes relocatable 
binary machine instruction code suitable for loading by LINK, the 
system's linking loader, 

MACRO is a statement-oriented language; statements are in free format 
and are processed in two passes. In processing statements, the 
assembler : 

1. Interprets machine instruction mnemonics 

2. Accepts symbol definitions 

3. Interprets symbols 

4. Interprets pseudo-ops 

5. Accepts macro definitions 

6. Expands macros on call 

7. Assigns memory addresses 

8. Generates a relocatable binary program file (.REL file) for 
input to LINK 

9. Generates a program listing file showing source statements, 
the corresponding binary code, and any errors found 

10. Generates a UNIVERSAL file that can be searched by other 
assemblies 

In addition to translating machine instruction mnemonics and 
special-purpose operators called pseudo-ops, MACRO allows you to 
create your own language elements, called macros. In this way you can 
tailor the assembler's functions for each program. 

Since the assembler is device independent, you can use any peripheral 
devices for input and output files. For example, you can use a 
terminal for your source program input, a line printer for your 
program listing output, and a disk for your binary program output. 

MACRO programs must use the monitor for device-independent 
input/output services. (See the Monitor Calls manual.) 
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NOTES 

The following conventions are used 
throughout this manual: 

1. All numbers in the examples are 
octal unless otherwise indicated. 

2. All numbers in the text are decimal 
unless otherwise indicated. 

3. The name of the assembler, MACRO, 
appears in uppercase letters; 
references to user-defined macros 
appear in lowercase letters. 

4. Examples sometimes show the code 
generated as it appears in the 
program listing file. This file is 
described in Section 6.1. 



1.1 HOW THE ASSEMBLER OPERATES 

MACRO is a 2-pass assembler; it reads your source program twice. On 
Pass 1, some symbolic addresses will not be resolved, if they refer to 
parts of the program not yet read. These symbolic references are 
entered in the symbol table and will be resolved on Pass 2. 

The main purpose of Pass 1 is to build symbol tables and to make a 
rudimentary assembly of each source statement. 

The first task of Pass 1 is initializing all impure data areas that 
MACRO uses (internally) for assembly. This area includes all dynamic 
storage areas and all buffer areas. 

MACRO then reads a command string into memory. This command string 
contains specifications for the files to be used during assembly. 
After scanning the command string for proper syntax, MACRO initializes 
the specified output files. 

As assembly begins, MACRO initiates a routine that retrieves source 
lines from the proper input file. If no such file is currently open, 
MACRO opens the next input file specified in the command string. 
Source lines are assembled as they are retrieved from input files. 

Assembly Pass 2 performs the same steps as Pass 1. However, during 
Pass 2 MACRO writes the object code to the binary (and usually 
relocatable) output file; it also generates the program listing file, 
followed by the symbol table listing for the program. 

MACRO can also generate a cross-referenced symbol table. (See Chapter 
6.) 

During Pass 2 MACRO also flags erroneous source statements with 
single-character error codes. (See Chapter 7.) These error codes 
appear in the program listing file. 
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The relocatable binary object file created during Pass 2 contains all 
binary code generated; this code is in a form suitable for loading by 
the LINK program. (See the LINK Reference Manual .) 

MACRO processes relocation counters on both passes. If a labeled 
statement has a different relocation value on the second pass, MACRO 
generates a phase error. 



1.2 ADDRESSES AND MEMORY 

The address space of a DECsystem-10 program consists of 256K (IK = 
1024 words), each word having 36 bits. Since the total number of 
storage locations is 2 to the 18th power, the address of a location 
can be expressed in 18 bits, or one halfword. 

The left halfword of a storage location is bits to 17; the right 
halfword is bits 18 to 35. 



1.3 RELOCATABLE ADDRESSES 

Normally the binary program generated by MACRO is relocatable. This 
means that when the program is loaded for execution, it can be loaded 
anywhere in physical memory. (The address for loading is selected at 
load time, and depends on what has already been loaded.) 

Unless you specify otherwise, MACRO assembles your binary program 
beginning with address (400000 for high-segment code). References 
to addresses within your program are therefore relative to (400000 
for the high segment), and must be changed at loading time. LINK does 
this by adding the load address to all such relative addresses, 
resolving them to absolute addresses. 

For programs assembled with multiple PSECT counters, each PSECT begins 
with the relative address 0. At load time, each PSECT has its own 
relocation constant; PSECT origins must be selected carefully to 
avoid overlapping of PSECTs in memory. 
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ELEMENTS OF MACRO 



The character set recognized in MACRO statements includes all ASCII 
alphanumeric characters and 28 special characters (ASCII 040 through 
137) . Lowercase letters (ASCII 141 through 172) are treated 
internally as uppercase letters (ASCII 101 through 132) . 

MACRO also recognizes seven ASCII control codes: horizontal tab 
(Oil), linefeed (012), vertical tab (013), formfeed (014), carriage- 
return (015), CTRL/underscore (037), and CTRL/Z (032). 

MACRO accepts any ASCII character in quoted text, or as text arguments 
to the ASCII and ASCIZ pseudo-ops. 

NOTES 

1. The line-continuation character 
(CTRL/_) is always effective. 

2. Delimiters for certain pseudo-ops 
(such as ASCII, ASCIZ, and COMMENT) 
can be any nonblank, nontab ASCII 
character . 



Characters and their codes are listed in Appendix A. 

A MACRO program consists of statements made up of MACRO language 
elements. Separated into general types, these are: 

1. Special characters 

2. Numbers 

3. Literals 

4. Symbols 

5. Expressions 

6. MACRO-def ined mnemonics 

7. Pseudo-ops 

8. Macros 

The format of a MACRO statement is discussed in Chapter 4. 
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2.1 SPECIAL CHARACTERS 

Characters and combinations that have special interpretations in MACRO 
are listed in Appendix B. These interpretations apply only in the 
contexts described. In particular, they do not apply within comment 
fields or text strings. 



2.2 NUMBERS 

The two properties of numbers that are important to MACRO are: 

1. In what radix (base) the number is given 

2. How the number should be placed in memory 

You can control the interpretation of these properties by using 
pseudo-ops or special characters to indicate your choices. 

2.2.1 Integers 

MACRO stores an integer in its binary form, right justified in bits 1 
to 35 of its storage word. If you use a sign, place it immediately 
before the integer. (If you omit the sign, the integer is assumed 
positive.) For a negative integer, MACRO first forms its absolute 
value in bits 1 to 35, then takes its two's complement. Therefore a 
positive integer is stored with in bit 0, while a negative integer 
has 1 in bit 0. 

The largest integer that MACRO can store is 377777 777777 (octal) ; 
the smallest (most negative) is 400000 000000 (octal) . 



2.2.2 Radix 

The initial implicit radix for a MACRO program is octal (base 8). The 
integers you use in your program will be interpreted as octal unless 
you indicate otherwise. 

You can change the radix to any base from 2 to 10 by using the RADIX 
pseudo-op. (See the pseudo-op RADIX in Chapter 3.) The new radix 

will remain in effect until you change it. 

Without changing the prevailing radix, you can write a particular 
expression in binary, octal, or decimal. To do this, prefix the 
integer with ~B for binary, "0 for octal, or ~D for decimal. The 
indicated radix applies only to the single integer immediately 
following it. 
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NOTES 



1. A single-digit number is always 
interpreted as radix 10. Thus 9 is 
seen as decimal 9, even if the 
current radix is 8. 

2. In the notations for *B, ~D, and "0, 
the up-arrow in the text indicates 
the up-arrow character, not the 
CONTROL character. 



For example, suppose the current radix is 8. Then you can write the 
decimal number 23 as: 

27 octal (current radix) 

"D23 decimal 

"B10111 binary 

But you cannot write decimal 23 as "D45-22 since the "D applies only 
to the first number, 45; the 22 is octal. However, you can write 
decimal 23 as ~D<45-22>. 



2.2.3 Adding Zeros to Integers in Source Code 

You can add zeros to an integer (multiply it by a constant) in your 
program by suffixing K, M, or G to it. 

K adds 3 zeros (K = "kilo-", thousands) 
M adds 6 zeros (M = "mega-", millions) 
G adds 9 zeros (G = "giga-", billions) 

These zeros are suffixed before any conversion, so that in radix 10, 
5K means 5000 decimal; in radix 8, 5K means 5000 octal, or 2560 
decimal . 



2.2.4 Fixed-Point Decimal Numbers 

To indicate a fixed-point decimal number, prefix it with ~F, include a 
decimal point wherever you wish, and suffix Bn to show that you want 
to place the "assumed point" after bit n in the storage word. If you 
omit the decimal point, MACRO assumes that it follows the last digit. 
If you omit the Bn, MACRO assumes B35. 

To handle the number, MACRO forms the integer part in a fullword 
register, and the fractional part in another fullword register. It 
then places the integer part (right justified) in bits 1 to n (n is 
from your Bn) of a binary word, and the fractional part (left 
justified) in the remaining bits. The integer part is truncated at 
the left, and the fractional part at the right. Bit shows the sign 
of the number. 
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For example, "F123.45B8 is formed in two registers as 

000000 000173 (integer part, right justified) 

346314 631462 (fractional part, left justified) 

Since the Bn operator sets the assumed point after bit 8, the integer 
part is placed in bits 1 to 8, and the fractional part in bits 9 to 
35. (The sign bit is 0, showing a positive number.) Truncation is 
on the left and right, respectively, giving 



173 



346 314631 



assumed point 

You can show a fixed-point decimal number as negative by placing a 
minus sign before the ~F. The absolute value of the negative number 
is formed in two registers as a positive number, then two's 
complemented. This complementing sets bit to 1, showing that the 
number is negative. 



NOTE 

The binary number resulting from ~F does 
not show where the assumed point should 
be. You must keep track of this through 
your own programming conventions. 



Examples : 

000000 000173 

000173 346314 

346314 631462 

777777 777604 

777604 431463 

431463 146316 



"F123.45 

"F123.45B17 

T123.45P-1 

-'T123.45 
-~F123.45B17 
-T123.45B--1 



2.2.5 Floating-Point Decimal Numbers 

In your program, a floating-point decimal number is a string of digits 
with a leading, trailing, or embedded decimal point and an optional 
leading sign. MACRO recognizes this as a mixed number in radix 10. 

MACRO forms a floating-point decimal number with the sign in bit 0, a 
binary exponent in bits 1 to 8, and a normalized binary fraction in 
bits 9 to 35. 

The normalized fraction can be viewed as follows: its numerator is 
the binary number in bits 9 to 35, whose value is less than 2 to the 
28th power, but greater than or equal to 2 to the 27th power. Its 
denominator is 2 to the 28th power, so that the value of the fraction 
is always less than 1, but greater than or equal to 0. (This value is 
only if the entire stored number is 0.) 
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The binary exponent is incremented by ^128 so that exponents from -128 
to 127 are represented as to 255. 

For a negative floating-point decimal number, MACRO first forms its 
absolute value as a positive number, then takes the two's complement 
of the entire word. 

Examples : 

The floating-point number 17. generates the binary 

10 000 101 100 010 000 000 000 000 000 000 000 

where bit shows the positive sign, bits 1 to 8 show the binary 
exponent, and bits 9 to 35 show the proper binary fraction. The 
binary exponent is 133 (decimal), which after subtracting the added 
128 gives 5. The fraction is equal to 0.53125 decimal. And 0.53125 
times 2 to the 5th power is 17, which is the number given. 

Similarly, 153. generates 

10 001 000 100 110 010 000 000 000 000 000 000 
while -153. generates 

1 01 110 111 011 001 110 000 000 000 000 000 000 

These two examples show that a negative number is two's complemented. 
Notice that since the binary fraction for a negative number always has 
some nonzero bits, the exponent field (taken by itself) appears to be 
one's complemented. 

As in FORTRAN, you can write a floating-point decimal number with a 
suffixed E±n, and the number will be multiplied by 10 to the ±nth 
power. If the sign is missing, n is assumed positive. 

Examples: 

2840000. can be written 284. E+4 

2840000. can be written .284E7 

.0000284 can be written .284E-4 

.0000284 can be written 284. E-7 

Using this E notation with an integer (no decimal point) is not 
allowed, and causes an error. Therefore you can use 284. E4, but 284E4 
is illegal. 

NOTE 

MACRO'S algorithm for handling numbers 
given with the E notation is not 
identical to FORTRAN'S. The binary 
values generated by the two translators 
may differ in the lowest order bits. 
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2.2.6 Binary Shifting 

Binary shifting of a number with Bn sets the location of the rightmost 
bit at bit n in the storage word, where n is a decimal integer. The 
shift takes place after the binary number is formed. Any bits shifted 
outside the range (bits to 35) of the storage word are lost. 

For example, here are some numbers with their binary representations 
given in octal : 

300000 000000 "i:i;3B2 

000000 042000 "M 7E<25 

000001 000000 1B17 
400000 000000 1B0 
777777 777777 --IB 3 5 
000000 00000.1. :LB35 
000000 777777 --lEGS 



2.2.7 Underscore Shifting 

You can also shift a number by using the underscore operator. (On 
some terminals this is a left-arrow.) If V is an expression with 
value n, suffixing _V to a number shifts it n bits to the left. (If n 
is negative, the shift is to the right.) 

In an expression of the form W_V, W and V can be any expressions 
including symbols. The binary value of W is formed in a register, V 
is evaluated, and the binary of W is shifted V bits when placed in 
storage . 

NOTE 

An expression such as -3 . 75E4 _~D18 is 
legal, but the shift occurs after 
conversion to floating-point decimal 
storage format. Therefore the sign, 
exponent, and fraction fields are all 
shifted away from their usual locations. 
This is true also for other storage 
formats . 



2.2.8 Querying the Position of a Bit Pattern 

You can query the position of a bit pattern by prefixing ~L (up-arrow 
L) to an expression. This generates the number of leading zeros in 
the binary value of the expression. ("LO generates 36 decimal.) 
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For example, suppose the current radix is 10. Then 

"L153 generates 35 (29 decimal) 

"L153. generates 1 

"L-153 generates 

"L-153. generates 

In the first example, ~L153 generates 29 (decimal) because the binary 
representation of 153 decimal has its leftmost 1 in bit 28: 

000 000 000 000 000 000 000 000 000 010 011 001 

But in the second example, the binary form of 153. is in 
floating-point format (see Section 2.2.5), 

010 001 000 100 110 010 000 000 000 000 000 000 

and its leftmost 1 is in bit 1. 

In both of the last two examples, "L-153 and "L-153. generate 0. This 
is because a negative number in any format sets bit to 1. 

2.3 LITERALS 

A literal is a character string within square brackets inserted in 
your source code. MACRO stores the code generated by the enclosed 
string in a literal pool beginning with the first available literal 
storage location, and places the address of this location in place of 
the literal. The literal pool is normally at the end of the binary 
program. (See the pseudo-op LIT in Chapter 3.) 

The statements 

1 35 010 00 0020 1 6 ' LDB T 1 1 C PC) I NT 6 t ♦ JB VEER > 1 7 1 

L I T 
22 06 00 000:1.37 

are equivalent to 

135 01 00 002020' LDB Tl t PLACE 

22 06 00 000137 PLACE: POINT 6>*JBVERvl7 

A literal can also be used to generate a constant: 

P U 8 H 1 7 y C 11 i G e n e r a t f? z © r o f u 1 1 w o r d 

MOVE Ly ZZ* y 11 ? Generate a word with 3 :i.n 

y left ha If and 14 in riahthalf 
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Multiline literals are also allowed: 

GETCHR: IL.DB T2>T1 ?Get a character 

C A I N T 2 > J I s i t a n u 1 1 ? 

J R S T C M V E T 1 » T X T P T R ? Y e s » ret r :i. e v e p o i n t e r 
I L. D E< T 2 f T I. y G e t a n e w c h a r a c t e r 
CAIN T 2 ? " ? " PI s 1 1 a o l.i e <;> t i o n iri a r k ? 
JRST CMOVEL' T1»TXTF :, T1 JYes» Set alternate pointer 
ILDB T2yT.l J Get the message character 
J R G T (j E T H L P II ? G o t o ?>£■?! p r (J i..i l, :i. n e 
P F'J P»] J N o t a i. j e <;> t i o n m a r> M. » r e t u r rV 
POP. J P» J Not a nullf return 

The text of a literal continues until a matching closing square 
bracket is found (unquoted and not in comment field). 

A literal can include any term, symbol, expression, or statement, but 
it must generate at least one but no more than 99 words of data. A 
statement that does not generate data (such as a direct-assignment 
statement or a RADIX pseudo-op) can be included in a literal, but the 
literal must not consist entirely of such statements. 

You can nest literals up to 18 levels. You can include any number of 
labels in a literal, but a forward reference to a label in a literal 
is illegal. 

If you use a dot (.) in a literal to retrieve the location counter, 
remember that the counter is pointing at the statement containing the 
literal, not at the literal itself. 

In nested literals, a dot location counter references a statement 
outside the outermost literal. 

In the sequence 

JRST CHRRZ AClrV 

CAIE AClrOP 

JRST ♦ + !. 

JRST EVTSTSLl 
SK.IPE C 

the expression .+1 generates the address of SKIPE C, not JRST EVTSTS. 

Literals having the same value are collapsed in MACRO'S literal pool. 
Thus for the statements: 

PUSH P,l.O] 

push p»co::i 

MOVE! AC. I t r ASCI Z /TEST 1/3 

the same address is shared by the two literals [0] , and by the null 
word generated at the end of [ASCIZ /TEST1/] . Literal collapsing is 
suppressed for those literals that contain errors, undefined 
expressions, or EXTERNAL symbols. 
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2.4 SYMBOLS 

MACRO symbols include: 

1. MACRO-def ined pseudo-ops (discussed in Chapter 3) 

2. MACRO-def ined mnemonics (discussed in Section 2.6) 

3. User-defined macros (discussed in Chapter 5) 

4. User-defined opdefs (discussed at OPDEF in Chapter 3) 

5. User-defined labels (discussed in this section) 

6. Direct-assignment symbols (discussed in Section 2.4.2.2) 

7. Dummy-arguments for macros (discussed in Chapter 5) 
MACRO stores symbols in three symbol tables: 

1. Op-code table: machine instruction mnemonics and pseudo-ops 

2. Macro table: macros, user-defined OPDEFs, and synonyms 
(See the SYN pseudo-op in Chapter 3.) 

3. User symbol table: labels and direct-assignment symbols 

An entry in one of these tables shows the symbol, its type, and its 
value. 

Symbols are helpful in your programs because: 

1. Defining a symbol as a label gives a name to an address. You 
can use the label in debugging or as a target for program 
control statements. 

2. In revising a program, you can change a value throughout your 
program by changing a symbol definition. 

3. You can give names to values to make computations clearer. 

4. You can make values available to other programs. 



2.4.1 Selecting Valid Symbols 

Follow these rules in selecting symbols: 

1. Use only letters, numerals, dots (.), dollar signs ($), and 
percent signs (%) . MACRO will consider any other character 
(including a blank) as a delimiter. 

2. Do not begin a symbol with a numeral. 

3. If you use a dot for the first character, do not use a 
numeral for the second. Do not use dots for the first two 
characters; doing so can interfere with MACRO'S created 
symbols. (See Section 5.5.2.) 

4. Make the first six characters unique among your symbols. You 
can use more than six characters, but MACRO will use only the 
first six. 
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Examples: 

VELOCITY (legal, only VELOCI is meaningful to MACRO) 

CHG.VEL (legal, only CHG.VE is meaningful to MACRO) 

CHG VEL (illegal, looks like two symbols to MACRO) 

1STNUM (illegal, begins with a numeral) 

NUM1 (legal) 

.1111 (illegal, begins with dot-numeral) 

..1111 (unwise, could interfere with created symbols) 



2.4.2 Defining Symbols 

You can define a symbol by making it a label or by giving its value in 
a direct-assignment statement. Labels cannot be redefined, but 
direct-assignment symbols can be redefined anywhere in your program. 

You can also define special-purpose symbols called OPDEFs and macros 
using the pseudo-op OPDEF and the pseudo-op DEFINE. (See Chapter 3.) 



2.4.2.1 Defining Labels - A label is always a symbol with a suffixed 
colon. A label is in the first (leftmost) field of a MACRO statement 
and is one of the forms: 



ERRFOUND: 

CASE1: 

OK:CONTIN: 

CASE2: : 

CASE3: ! 

CASE4: : ! 



(MACRO uses only ERRFOU) 

(legal label) 

(legal; you can use more than one label 
at a location) 

(double colon declares label INTERNAL; 
see Section 2.4.5.2) 

(colon and exclamation point suppresses 
output by debugger) 

(double colon and exclamation point 
declares label INTERNAL and suppresses 
output by debugger) 
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When MACRO processes the label, the symbol and the current value of 
the location counter are entered in the user symbol table. A 
reference to the symbol addresses the code at the label. 

You cannot redefine a label to have a value different from its 
original value. A label is relocatable if the address it represents 
is relocatable; otherwise it is absolute. 



2.4.2.2 Direct Assignments - You define a direct-assignment symbol by 
associating it with an expression. (See Section 2.5 for a discussion 
of expressions.) A direct assignment is in one of the forms: 

symbol=expression (symbol and value of expression are 

entered in user symbol table) 

symbol==expression (symbol and value of expression are 

entered in user symbol table, output by 
debugger is suppressed) 

symbol=:expression (symbol and value of expression are 

entered in user symbol table, symbol is 
declared INTERNAL; see Section 2.4.5.2) 

symbol==:expression (symbol and value of expression are 

entered in user symbol table, symbol is 
declared INTERNAL, output by debugger is 
suppressed) 

You can redefine a direct-assignment symbol at any time; the new 
direct assignment simply replaces the old definition. 

NOTE 

If you assign a multiword value using 
direct assignment, only the first word 
of the value is assigned to the symbol. 
For example, A=ASCIZ /ABCDEFGH/ is 
equivalent to A=ASCIZ /ABCDE/, since 
only the first five characters in the 
string correspond to code in the first 
word . 



2.4.3 Variable Symbols 

You can specify a symbol as a variable by suffixing it with a number 
sign (#). A variable symbol needs no explicit storage allocation. On 
finding your END statement, MACRO assembles variables into locations 
following the literal pool. 

You can assemble variables anywhere in your program by using the VAR 
pseudo-op. This pseudo-op causes all variables found so far to be 
assembled immediately. (Variables found after the VAR statement are 
assembled at the end of the program or at the next VAR statement.) 
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2.4.4 Using Symbols 

When you use a symbol in your program, MACRO looks it up in the symbol 
tables. Normally MACRO searches the macro table first, then the 
op-code table, and finally the user symbol table. However, if MACRO 
has already found an operator in the current statement and is 
expecting operands, then it searches the user symbol table first. 

You can control the order of search for symbol tables by using the 
pseudo-op .DIRECTIVE MACPRF. 



2.4.5 Symbol Attributes 

The value of a symbol is either relocatable or absolute. The 
relocatability of a label is determined by the relocatabil ity of the 
address assigned to it. You can define either an absolute or a 
relocatable value for a direct-assignment symbol. 

In addition, each symbol in your program has one of the following 
attributes: local, INTERNAL global, or EXTERNAL global. This 
attribute is determined when the symbol is defined. 



2.4.5.1 Local Symbols - A local symbol is defined for the use of the 
current program only. You can define the same symbol to have 
different values in separately assembled programs. A symbol is local 
unless you indicate otherwise. 



2.4.5.2 Global Symbols - A global symbol is defined in one program, 
but is also available for use in other programs. Its table entry is 
visible to all programs in which the symbol is declared global. 

A global symbol must be declared INTERNAL in the program where it is 
defined; it can be defined in only one program. In other programs 
sharing the global symbol, it must be declared EXTERNAL; it can be 
EXTERNAL in any number of programs. 

To declare a symbol as INTERNAL global, you can: 

1. Use the INTERN pseudo-op. 

INTEIRN FLAG1 

2. Insert a colon after = in a direct-assignment statement. 

FLAG2=:200 
FLAG3~=:200 

3. Use an extra colon with a label. 

FLAG4: : 

4. B'or subroutine entry points, use the ENTRY pseudo-op. (This 
pseudo-op does more than declare the symbol INTERNAL. See 
Chapter 3.) 

ENTRY FI...AG5 
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To declare a symbol as an EXTERNAL global, you can: 

1. Use the EXTERN pseudo-op. 

EXTERN FL..AG6 

2. Suffix ## to the symbol at any of its uses. (Doing this once 
is sufficient, but you can use ## with all references to the 
symbol . ) 

FLAG7** 



2.5 EXPRESSIONS 

You can combine numbers and defined symbols with arithmetic and 

logical operators to form expressions. You can nest expressions by 

using angle brackets. MACRO evaluates each expression (innermost 

nesting levels first), and either resolves it to a fullword value, or 

generates a Polish expression to pass to LINK. (See Sections 2.5.3 
and 2.5.4.) 



2.5.1 Arithmetic Expressions 

An arithmetic expression can include any number or defined symbol, and 
any of the following operators: 

+ addition 

subtraction 

* multiplication 

/ division 

These examples assume that WORDS, X, Y, and Z have been defined 
elsewhere : 

MOVEI 3 r WORDS/5 

ADD I 12»<X+Y-Z> 

A D D I 1 2 1 ■■•: ••:.' Id R D S / 5 > + .1 > * 5 



2.5.2 Logical Expressions 

A logical expression can include any number or defined symbol whose 
value is absolute, and any of the following operators: 

& AND 

! OR (inclusive OR) 

~! XOR (exclusive OR) 

"- NOT 
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The unary operation "-A generates the fullword one's complement of the 
value of A. 

Each of the binary operations &, !, and " ! generates a fullword by 
performing the indicated operation over corresponding bits of the two 
operands. For example, A&B generates a fullword whose bit is the 
result of A's bit ANDed with B's bit 0, and so forth for all 36 

bits . 



2.5.3 Polish (Complex) Expressions 

MACRO cannot evaluate certain expressions containing relocatable 
values or EXTERNAL symbols. Instead MACRO generates special 
expressions called Polish expressions, which tell LINK how to resolve 
the values at load time. MACRO also generates Polish expressions to 
resolve inter-PSECT references. 

For example, assume that A and B are externally defined symbols. Then 
MACRO cannot perform the operations A+B-3, but instead generates a 
special Polish block containing an expression to pass to LINK; the 
expression is equivalent to -+AB3. (See REL Block Type 11 in the LINK, 
Reference Manual .) At load time, the values of A and B are available 
to LINK, and the expression is resolved. 

NOTE 

If you have used reverse Polish notation 
with a calculator, you should notice 
that although MACRO'S Polish expressions 
are similar, they are not reversed. 
(These notations are called Polish 
because they were invented by the Polish 
logician Jan Lukasiewicz.) 



2.5.4 Evaluating Expressions 



2.5.4.1 Hierarchy of Operations - MACRO has a hierarchy of operations 
in evaluating expressions. In an expression without nests (angle 
brackets), or within a nested expression, MACRO performs its 
operations in this effective order: 

1. All unary operations and shifts: +, -, "-, ~D, ~0, ~B, B 

(binary shift) , _ (underscore shift), "F, ~L, E, K, M, G. 
Zeros are added for K, M, and G before any other operation is 
performed . 

2. Logical binary operations (from left to right): ! (OR), " ! 
(XOR) , & (AND) . 

3. Multiplication and division (from left to right): *, /. 

4. Addition and subtraction (binary operations): +, -. 
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You can override this hierarchy by using angle brackets to show what 
you want done first. For example, suppose you want to calculate the 
sum of A and B, divided by C. You cannot do this with A+B/C because 
MACRO will perform the division B/C first, then add the result to A. 
With angle brackets you can write the expression <A+B>/C, telling 
MACRO to add A and B first, then divide the result by C. 

Expressions can be nested to any level. The innermost nest is 
evaluated first; the outermost, last. Some examples of legal 
expressions (assuming that Al, Bl, and C are defined symbols) are: 

AlfBl/5 

<Al+Bl>/5 

~-Al*Bl~!C 



NOTE' 

An expression given in halfword notation 
(that is, lef thalf , ,r ighthalf ) has each 
half evaluated separately in a 36-bit 
register. Then the 18 low-order bits of 
each half are joined to form a fullword. 
For example, the expression <4,,6>/2 
generates the value 000002 000003. 



2.5.4.2 Evaluating Expressions with Relocatable Values - The value of 
an expression is usually either absolute or relocatable. Recall that 
relocatable values in your binary code will have the relocation 
constant added at load time by LINK. 

Assume that A and B are relocatable symbols, and that X and Y are 
absolute symbols, and that the relocation constant is k. Let a+k and 
b+k be the values of A and B after relocation. Then A+x makes sense 
(to LINK) because it means <a+k>+X, which is the same as <a+X>+k, 
clearly relocatable. 

Since X and Y are both absolute, any operation combining them gives an 
absolute result. 

Now look at the expression A+B. This means <a+k>+<b+k>, which is the 

same as <a+b>+2k, neither absolute nor relocatable. Similarly, A*B 

means <a+k>*<b+k>, or <a*b>+<a+b>*k+k*k , again neither absolute nor 

relocatable. Such expressions cannot be evaluated by MACRO and are 
passed as Polish expressions to LINK. 

More generally, you can see if an expression is absolute or 
relocatable by substituting relocated forms as above (for example, 
a+k), and separating it (if possible) into the form 

absolute+n*k 

where absolute is an absolute expression. If n=0, the expression is 
absolute; if n=l, it is relocatable. If n is neither nor 1, or if 
the expression cannot be put into the form above, then the expression 
is neither absolute nor relocatable. (Nevertheless, LINK will 
correctly evaluate the expression at load time.) 
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2.6 MACRO-DEFINED MNEMONICS 

MACRO-def ined mnemonics are words that MACRO recognizes and can 
translate to binary code. These mnemonics include: 

1. Machine instruction mnemonics 

2. I/O instruction mnemonics 

3. I/O device code mnemonics 

4. KL10 EXTEND instruction mnemonics 

5. JRST and JFCL mnemonics 

6. DECsystem-10 monitor call mnemonics 

7. DECsystem-10 CALLI mnemonics 

8. DECsystem-10 TTCALL mnemonics 

9. DECsystem-10 MTAPE mnemonics 

10. F40-swi tch-dependent mnemonics 

Each type of mnemonic is discussed and tabulated in Appendix C. These 
mnemonics, together with MACRO'S pseudo-ops and special characters, 
form the MACRO language. 
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CHAPTER 3 
PSEUDO-OPS 



A pseudo-op is a statement that directs the assembler to generate code 
or set switches to control assembly and listing of your program. For 
example, the pseudo-op RADIX does not generate code, but it tells 
MACRO how to interpret numbers in your program. The pseudo-op EXP 
generates one word of code for each argument given with it. 

To use a pseudo-op in your program, follow it with a space or tab, and 
any required or optional arguments or parameters. The program 
examples in Appendix D show pseudo-ops used in context. 

This chapter describes the use and functions of each pseudo-op 
(alphabetically). The headings included for each description, if 
applicable, are: 

1 . FORMAT 

2. FUNCTION 

3. EXAMPLES 

4. OPTIONAL NOTATIONS 

5. RELATED PSEUDO-OPS 

6. COMMON ERRORS 

Some entries under COMMON ERRORS cite single-character error codes 
(for example, M error). These codes are discussed in Section 8.2. 

Many of the examples show some parts of the code assembled. The 
format and meaning of assembled code is discussed in Section 6.1. 
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ARRAY 



FORMAT 



FUNCTION 



ARRAY sym [expression] 

expression = an integer value in the current radix, 
indicating the number of words to be allocated; 
the expression cannot be EXTERNAL, relocatable, or 
a floating-point decimal number, and its value 
must not be negative. 

Reserves a block of storage whose length is the value 
of the expression, and whose location is identified by 
the symbol. Storage is allocated along with other 
variable symbols in the program. 

If the pseudo-op TWOSEG is used, ARRAY storage must be 
in the low segment. (See the VAR pseudo-op.) 

The allocated storage is not necessarily zeroed. 

If you use ARRAY in a PSECT, storage is allocated 
within that PSECT. 



NOTE 

Though the expression portion of an OPDEF must 
be in square brackets, this use of the brackets 
is completely unrelated to literals or literal 
handl ing . 



EXAMPLES 



ARRAY ST ART C 200.1 
ARRAY PLACET J. 000 1 
ARRAY ERRS £ 2000 1 



OPTIONAL 
NOTATIONS 



ARRAY syml,sym2 [expression] 

Both syml and sym2 have a length equal to the value of 
the expression. 



RELATED 
PSEUDO-OPS 



BLOCK, .COMMON, INTEGER, VAR 



COMMON 
ERRORS 



Using an EXTERNAL symbol for name or size of the array 
(E error) . 
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ASCII 



FORMAT 



FUNCTION 



ASCII dtextd 

d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

text = string of text characters to be entered. 

Enters ASCII text in the binary code. Each character 
uses seven bits. Characters are left justified in 
storage, five per word, with bit 35 in each word set to 
0, and any unused bits in the last word set to 0. 



EXAMPLES 



105 122 122 117 122 
040 115 105 123 123 
101 107 105 000 000 

123 124 101 122 124 
111 116 107 040 101 
107 101 111 116 000 

105 116 104 123 040 
127 111 124 110 040 
132 105 122 117 123 



ASCII /ERROR MESSAGE/ 



ASCII .'STARTING AGAIN! 



ASCII ?ENDS WITH ZEROS? 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Omit the space or tab after ASCII. This is not allowed 
if the delimiter is a letter, number, dot, dollar sign, 
or percent sign (that is, a possible symbol 
constituent) , or if the ASCII value of the delimiter 
character is less than 040 or greater than 172. 

Right justified ASCII can be entered by using double 
quotes to surround up to five characters; for example, 

20.1. 01 00 000101 MOVEI AC1>'A" 
ASCIZ, .DIRECTIVE FLBLST, RADIX50, SIXBIT 

Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 

Using more than 5 characters in a right-justified ASCII 
string, or more than 2 characters if in the address 
field (Q error) . 

Giving direct assignment of a long ASCII string value 
to a symbol (for example A=ASCII /ABCDEFGH/) . Only the 
first word (five characters, left justified) is 
assigned . 

Using ASCII when ASCIZ is required. 
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ASCIZ 



FORMAT 



FUNCTION 



ASCIZ dtextd 

d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

text = string of text characters to be entered. 

Enters ASCII text exactly as in the pseudo-op ASCII, 
except that a trailing null character is guaranteed. 
That is, if the number of characters in text is a 
multiple of five, a fullword of zeros is generated. 



EXAMPLES 



105 122 122 117 122 
040 115 105 123 123 
101 107 105 0Q0 000 



ASCIZ /ERROR MESSAGE/ 



123 124 101 122 124 
111 116 107 040 101 
107 101 111 116 000 



ASCIZ ! STARTING AGAIN! 



105 116 104 123 040 
127 111 124 110 040 
132 105 122 117 123 
000 000 000 000 000 



ASCIZ TENDS WITH ZEROS? 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



Omit the space or tab after ASCIZ. This is not allowed 
if the delimiter is a letter, number, dot, dollar sign, 
or percent sign (that is, a possible symbol 
constituent) , or if the ASCII value of the delimiter 
character is less than 040 or greater than 172. 

ASCII, .DIRECTIVE FLBLST, RADIX50, SIXBIT 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter). 

Giving direct assignment of a long ASCII string value 
to a symbol (for example A=ASCII /ABCDEFGH/) . Only the 
first word (five characters, left justified) is 
assigned . 

In a macro, using a delimiter character that interferes 
with recognition of a dummy-argument. For example, in 
the macro 

DEFINE F00(X)< 
ASCIZ .X. 



X is not seen as a dummy-argument because .X. is itself 
a valid symbol. 

(Continued on next page) 
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ASCIZ (Cont.) 



In the macro 



DEFINE F00<X)< 
ASCIZ /X/ 



X is seen as a dummy-argument because the slash (/) is 
not valid in a symbol. 

The macro 

DEFINE FOO(X)< 
ASCIZ .'X'* 

uses the concatenation operator (') to assure 
recognition of X as a dummy-argument. (See Section 5.4 
for a discussion on concatenating arguments.) 
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.ASSIGN 



FORMAT 



FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



•ASSIGN syml ,sym2, increment 

syml and syin2 = global symbols. 

increment = expression with integer value. 

MACRO generates a REL Block Type 100. (See the LINK 
Reference Manual .) At the time the program is loaded 
into memory, assigns the value of sym2 to syml, and 
adds increment to sym2. 

The .ASSIGN pseudo-op is useful for assigning a block 
of storage in one module and providing another module 
with the symbols needed to reference that block. 



ASSIGN AyPCy5 



? A <r> s :i. tf n s t h e v & 1 u e o f P C t a A y 
9 then redefines the value of 
v PC to be PC+5. 



. A S S I G N E R R J. r E R R S t E R N ? A s s :i. s r-. s t h e value o f E R R S t o 

? I::.' R R .1. y t h e n v e d <■? f i n e s E R R S t o 
y be ERRS plus the current 
9 value of ERNG* 

.ASSIGN syml,sym2 

If the increment is missing, its value is 1. 

Syml or sym2 not global. 

Increment not defined at assembly time. 
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ASUPPRESS 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



ASUPPRESS 

Causes all local or INTERNAL symbols that are not 
referenced after the ASUPPRESS to be deleted from 
MACRO'S symbol table at the end of Pass 2. These 
symbols will not be output to LINK, will not be 
available to the debugger, and will not appear in the 
symbol table in the program listing file. 

If you use ASUPPRESS at the end of Pass 1, only those 
symbols defined or referenced in Pass 2 remain in 
MACRO'S symbol table. This is useful for parameter 
files that define many more symbols than are actually 
used, since the unused symbols can be automatically 
deleted if they are defined in IF1 conditionals. 

PURGE, SUPPRESS 
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BLOCK 



FORMAT 



FUNCTION 



EXAMPLES 



BLOCK expression 

expression = an integer, value in the current radix, 
indicating the number of words to be allocated; 
the expression cannot be EXTERNAL, relocatable, or 
a floating-point decimal number, and its value 
must not be negative. 

Reserves a block of locations whose length is the value 
of the expression. The location counter is incremented 
by this value. The allocated locations are not 
necessarily zeroed. 

Note that the BLOCK pseudo-op does not generate or 
store code. Therefore it should not be used in a 
literal, since this will result in overwriting the 
reserved space during literal pooling. 

If you use the BLOCK pseudo-op to reserve words meant 
for data storage, these words should be reserved in the 
low segment of a two-segment program. 



002101' 200 02 00 400033' 
002102' 251 02 00 003010' 



MOVE 2»CXWD FRMfTOJ 
BLT 2»T0END 



002611 ' 
002711' 



003010' 



frm: 


BLOCK 100 


to: 


BLOCK 100 




T0END=.-1 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Use the pseudo-op Z inside literals. 

ARRAY, .COMMON, INTEGER, VAR 

Relocatable expression (R error). 
Floating-point or negative expression (A error) 
Value of expression larger than 777777. 
Expression contains EXTERNAL symbol (E error). 
Expression contains nonexistent symbol (V error 
BLOCK used in literal (L error). 



3-1 



PSEUDO-OPS 



BYTE 



FORMAT 



FUNCTION 



EXAMPLES 



COMMON 
ERRORS 



BYTE bytedef ... bytedef 

bytedef=(n) expression, . . ,,expression 

n = byte size in bits; n is a decimal expression in 
the range 1 to 36. 

expression = value to be stored. 

Stores values of expressions in n-bit bytes, starting 
at bit of the storage word. The first value is 
stored in bits to n-1; the second in bits n to 2n-l; 
and so forth for each given value. 

If a byte will not fit in the remaining bits of a word, 

the bits are zeroed and the byte begins in bit of the 

next word. If a value is too large for the byte, it is 
truncated on the left. 

If the byte size is or is missing (empty 
parentheses), a zero word is generated. 

000002 VEL0CY=2 
05 00 00 01 05 02 BYTE <6>5»0r r 101 »5> VELOCY 

generates the storage value 050000 010502. The two 
commas indicate a null argument; the 101 (octal) is 
too large for the byte size and is left truncated. 

07 00 01 007 000 BYTE (6)7, Or 1 <9>7,0> 1 1 " A" 
001 101 000000 

Notice that the code for "A" (101) is right justified 
in its 9-bit byte. 

Byte size too big (A error). 

Missing left or right parenthesis (A error). 

Extraneous comma before left parenthesis; the comma 
generates a null byte. 

Using an EXTERNAL symbol or EXTERNAL complex expression 
for n or expression. 
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PSEUDO-OPS 



COMMENT 



FORMAT 



COMMENT dtextd 



d = delimiter; the first nonblank character, whose 
second appearance terminates the text. 

text = text to be entered as a comment. 



FUNCTION 



Treats the text between the delimiters as a comment. 
The text can include a CR-LF to facilitate multiline 
comments, as shown below. 



EXAMPLES 



COMMENT /THIS IS A COMMENT 
THAT IS MORE THAN 1 LINE LONG/ 



OPTIONAL Omit the space or tab after COMMENT. This is not 
NOTATIONS allowed if the delimiter is a letter, number, dot, 
dollar sign, or percent sign (that is, a possible 
symbol constituent) , or if the ASCII value of the 
delimiter character is less than 040 or greater than 
172. 

Use a semicolon ( ; ) to make the rest of the line into a 

comment . 



RELATED 
PSEUDO-OPS 



REMARK 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter). 
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PSEUDO-OPS 



. COMMON 



FORMAT 



FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.COMMON symbol [expression] 

symbol = name of a FORTRAN COMMON block. 

expression = an expression having a positive integer 
value; this value defines the length of the 
COMMON block. 

Defines a FORTRAN or FORTRAN-compatible COMMON block. 
Causes the equivalent action of a FORTRAN labeled 
COMMON. (See the FORTRAN Programmer's Reference 
Manual . ) 

You can use .COMMON to define blank COMMON; to do 
this, use the symbol .COMM. as the name of the COMMON 
block. (Both FORTRAN and LINK recognize this as the 
name of blank COMMON.) 

To define a COMMON block, MACRO generates a REL Block 
Type 20. (See the LINK Reference Manual .) 

If used, the .COMMON pseudo-op must precede any MACRO 
statement that generates binary code, and must precede 
any other reference to the symbol name. 

♦COMMON DATA1C503 

.COMMON symbol , . . . , symbol [expression] 

defines a COMMON array for each symbol given. Each 
array has a length equal to the value of the 
expression. 

ARRAY, BLOCK, EXTERN, INTEGER 



Missing left or right square bracket (A error). 



Using a relocatable value or EXTERNAL symbol 
expression. 



in 
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PSEUDO-OPS 



.CREF 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.CREF 

Resumes output of cross-referencing that was suspended 
by the .XCREF pseudo-op. 

Can apply to specific symbols to cancel a previous 
•XCREF on those symbols, as in 

. CREF symbol , . . . , symbol 

.XCREF 



Specifying a nonexistent symbol (A error). 
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PSEUDO-OPS 



DEC 



FORMAT 
FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 



DEC expression ,..., expression 

Defines the local radix for the line as decimal; the 
value of each expression is entered in a fullword of 
code. The location counter is incremented by 1 for 
each expression. 



000000 
203440 
202622 
055452 
000000 



000012 
000000 
077714 
456522 
000003 



RADIX 8 

DEC 10»4.5>3.1416,6*03E-26>3 



Use the EXP pseudo-op and prefix ~D to each expression 
that must be evaluated in radix 10. In the example 
above, only the first expression, "10," has different 
evaluations in radix 8 and radix 10. Therefore an 
equivalent notation is 



000000 
203440 
202622 
055452 
000000 



000012 
000000 
077714 
456522 
000003 



EXP ~D10,4.5,3.1416>6»03E-26,3 



RELATED 
PSEUDO-OPS 



EXP, RADIX, OCT 
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PSEUDO-OPS 



DEFINE 



FORMAT 



FUNCTION 

EXAMPLES 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



DEFINE macroname (darglist) <macrobody> 

macroname = a symbolic name for the macro defined. 
This name must be unique among all macro, OPDEF, 
and SYN symbols. 

darglist = a list of dummy-arguments. 

macrobody = source code to be assembled when the macro 
is called. 

Defines a macro. (See Chapter 5.) 

See Chapter 5. 

.DIRECTIVE (with .ITABM, . XTABM , or MACMPD arguments), 
IRP, IRPC, OPDEF, STOPI, SYN 

Mismatched parentheses. 

Mismatched angle brackets. 

Using identical names for a macro and an OPDEF or SYN 
symbol (X error) . 
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PSEUDO-OPS 



DEPHASE 



FORMAT 
FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 



DEPHASE 

Suspends the effect of a PHASE pseudo-op. Restores the 
location counter to its mode previous to the segment of 
PHASEd code. 

For further details, see the pseudo-op PHASE. 

400000' RELOC 400000 

000000 PHASE 

000000 201 01 00 000000 TAG: MOVEI IrO 
400001 ' DEPHASE 

400001' 254 00 00 000000' JRST TAG 

PHASE 
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PSEUDO-OPS 



DIRECTIVE 



FORMAT 
FUNCTION 



.DIRECTIVE directive,... directive 

Sets switches to enable or disable MACRO features. If 
a directive has a logical opposite, you can use NO as a 
prefix to reverse the directive. The directives are: 

. ITABM - include spaces and tabs as part . of passed 
arguments in macro call. 

.XTABM - strip leading and trailing spaces and tabs 
from passed arguments in macro call. .XTABM is 
the default setting. 

MACMPD - match paired delimiters in macro call. MACMPD 

is the default for assembly. It implies .XTABM 

and disables .ITABM. Using .DIRECTIVE NO MACMPD 

disables all quoting characters except angle 

brackets in macro arguments, and offers you a 
choice of .ITABM or .XTABM. 

LITLST - list all binary code for literals in-line. 

FLBLST - list only first line of binary code for 
multiline text. NO FLBLST is the default. 

.OKOVL - allow overflow for arithmetic and for the 
pseudo-ops DEC, EXP, and OCT. 

.EROVL - give an N error for arithmetic overflow. 
.EROVL is the default. 

MACPRF - prefer macro definition of symbol over other 
definitions of the same symbol. This does not 
affect the searching of . UNV files. 

SFCOND - suppress source listing for failing 

conditional assembly. The lines containing the 

opening and closing angle brackets are not 
suppressed . 

.NOBIN - do not generate binary (.REL) file. 

KA10 - enter KA10 as CPU type in header block of binary 
file. 

KI10 - enter KI10 as CPU type in header block of binary 
file. 

KL10 - enter KL10 as CPU type in header block of binary 
file. 



EXAMPLES 

COMMON 
ERRORS 



.DIRECTIVE' MACMPD, .NOBIN 

Using NO with a directive that does not have a logical 
opposite . 
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PSEUDO-OPS 



END 



FORMAT 



FUNCTION 



END expression 

expression = an optional operand that specifies the 
address of the first instruction to be executed; 
can be EXTERNAL. 

Must be the last statement in a MACRO program. 
Statements after END are ignored. The starting address 
is optional and normally is given only in the main 
program. (Since subprograms are called from the main 
program, they need not specify a starting address.) 

When the assembler first encounters an END statement, 
it terminates Pass 1 and begins Pass 2. The END 
terminates Pass 2 on the second encounter, after which 
the assembler simulates XLISTed LIT and VAR statements 
beginning at the current location. (In a PSECTed 
program, the LIT and VAR statements are simulated for 
each PSECT.) 



EXAMPLES 



END START- 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



START is a label at the starting address. 

Use the END statement to specify a transfer word in 
some output file formats. (See pseudo-ops RIM, RIM10, 
and RIM10B in Appendix E.) 

PRGEND 



COMMON 
ERRORS 



Failing to end a text string or literal with a 
closing delimiter; MACRO cannot see the END statement. 

Including an END statement in a source file when it is 
not the last file in a group of files you want 
assembled as a single program. 

Closing the input file immediately after the characters 
"END" with no following carriage return. 
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PSEUDO-OPS 



.ENDPS 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



.ENDPS 

Suspends use of the relocation counter associated with 
the current PSECT. If the current PSECT is nested in 
other PSECTs, the relocation counter for the next outer 
PSECT is activated. Otherwise, the relocation counter 
for the blank PSECT is activated. 

MACRO generates a REL Block Type 22. (See the LINK 
Reference Manual . ) 

For a complete discussion of PSECTs and their handling, 
see Section 9.1.3. 

Give the name of the current PSECT with the .ENDPS 
pseudo-op. For example, 

.ENDPS A 

causes MACRO to verify that A is the name of the 
current PSECT; if not, an error message is issued. 

LOC, .ORG, .PSECT, RELOC, TWOSEG 
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PSEUDO-OPS 



ENTRY 



FORMAT 



ENTRY symbol ,..., symbol 

symbol = name of an entry 
subroutine. 



point in 



library 



FUNCTION 



Defines each symbol in the list following the ENTRY 
pseudo-op as an INTERNAL symbol and places them in a 
REL Block Type 4 at the beginning of the .REL output 
file. If this .REL file is later included in an 
indexed library of subroutines, then the symbol will 
also be included in a REL Block Type 14 at the 
beginning of the library. (Except for this, ENTRY is 
equivalent to INTERN.) 

If LINK is in library search mode, a subroutine will be 
loaded if the program to be executed contains an 
undefined global symbol that matches a name in the 
library entry list for that program. 



Since library subroutines are external 
using them, the calling program must 
EXTERN statements. 



to programs 
list them in 



EXAMPLES 



If the MATRIX subroutine is a library subroutine, it 
must contain the statement 



ENTRY MATRIX 

in order to make the symbol MATRIX available to other 
programs. In addition, it must define the symbol 
MATRIX as a label at the address where execution of the 
call is to begin: 

matrix: 



RELATED 
PSEUDO-OPS 



INTERN, EXTERN 



COMMON 
ERRORS 



Not defining the symbol in the program. 

Purging an ENTRY symbol in Pass 2 only. The ENTRY 
symbol is normally output at the beginning of Pass 2; 
a PURGE of an ENTRY symbol must occur in Pass 1 to be 
effective. 
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PSEUDO-OPS 



EXP 



FORMAT 
FUNCTION 

EXAMPLES 



RELATED 
PSEUDO-OPS 



EXP expression ,... expression 

Enters the value of each expression (in the current 
radix) in a fullword of code. 



000003 

000101 

000004 

000002 

000000 000003 

000000 000004 

000000 000101 

000000 000101 

000000 000364 

DEC, OCT 



X=3 

HALF=101 

B=4 

A=2 

EXP Xr4,~EiA5,HALF,B+362~A 
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PSEUDO-OPS 



EXTERN 



FORMAT 
FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



EXTERN symbol, ... , symbol 

Identifies symbols as being defined in other programs. 
EXTERNAL symbols cannot be defined within the current 
program. 

At load time, the value of an EXTERNAL symbol is 
resolved by LINK if you load a module that defines the 
symbol as an INTERNAL symbol. (If you do not load such 
a module, LINK gives an error message for the undefined 
EXTERNAL symbol.) 

An EXTERNAL symbol cannot be used for any program 
values affecting address assignment (such as arguments 
to LOC or RELOC) . 

For a discussion of global symbols and their resolution 
by LINK, see Section 2.4.5.2. 

EXTERN SORT* CUBE > TYPE 

Suffix ## to the symbol. This declares the symbol 
EXTERNAL, and eliminates the need for the EXTERN 
pseudo-op. Most programmers who use the ## notation do 
so at all occurrences of the symbol to show at each 
site that the symbol is EXTERNAL. 

For example, the two statements 

EXTERN A 
ATU0=A*2 

can be simplified to 

ATU0=A##*2 

INTERN, ENTRY, UNIVERSAL 



Attempting to declare a symbol as EXTERNAL after its 
first use has made it local (by default) or INTERNAL 
(by declaration) . 

Declaring a symbol as EXTERNAL in a program that 
searches a UNIVERSAL file that gives a conflicting 
definition. 



3-21 



PSEUDO-OPS 



. HWFRMT 



FORMAT 

FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



.HWFRMT 

Causes binary code to be listed in halfword format 

200 01 02 000002 

200042 000002 

Use the /G switch described in Table 7-1. 

.MFRMT 



MOVE 1,2(2) 
.HWFRMT 
MOVE- It 2(2) 
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PSEUDO-OPS 



.IF 



FORMAT 
FUNCTION 



.IF expression , qualifier , <code> 

Gives criterion and code for conditional assembly. The 
code is assembled if: 



qualifier is 

ABSOLUTE 

ASSIGNMENT 

ENTRY 

EXTERNAL 

INTERNAL 

GLOBAL 

LABEL 

LOCAL 

LRELOCATABLE 

MACRO 

NEEDED 

NUMERIC 

OPCODE 

OPDEF 

REFERENCED 

RELOCATABLE 

RRELOCATABLE 

SYMBOL 

SYNONYM 



AND 



expression is 



absolute 

a direct-assignment symbol 

a symbol given in ENTRY pseudo-op 

an EXTERNAL symbol 

an INTERNAL or ENTRY symbol 

a global symbol 

a label 

a local symbol 

a lefthalf relocatable symbol 

a macro name 

an undefined but referenced symbol 

numeric 

an opcode 

a symbol defined by OPDEF pseudo-op 

a symbol already in the symbol table 

a relocatable symbol 

a righthalf relocatable symbol 

a symbol (instead of a number) 

a symbol defined by SYN pseudo-op 



NOTE 

If the expression has different properties in 
Pass 1 and Pass 2, the number of words of code 
generated may be different for each pass. 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.IF F00 , MACRO »<FQO> 

Abbreviate qualifier up to unique initial letters. 
For example, you can abbreviate OPCODE to OPC, but not 
to OP, since OPDEF has the same first two letters. 

Omit the comma preceding the left angle bracket. 

.DIRECTIVE SFCOND, .IFN, IFx group 

Omitting the comma between expression and qualifier. 

Mismatching angle brackets. 

Misplacing the .IF statement in such a way that the 

property given by the qualifier is different in Pass 1 

and Pass 2. For example, the following code generates 
phase errors in Pass 2: 

.if foo , opdef ><jfcl> 
opdef foocjrst! 
nxtlab: end 
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PSEUDO-OPS 



.IFN 



FORMAT 
FUNCTION 



.IFN expression, qualif ier , <code> 

Gives criterion and code for conditional assembly. The 
code is assembled if: 



qualifier is 

ABSOLUTE 

ASSIGNMENT 

ENTRY 

EXTERNAL 

INTERNAL 

GLOBAL 

LABEL 

LOCAL 

LRELOCATABLE 

MACRO 

NEEDED 

NUMERIC 

OPCODE 

OPDEF 

REFERENCED 

RELOCATABLE 

RRELOCATABLE 

SYMBOL 

SYNONYM 



AND 



expression IS NOT 



absolute 

a direct-assignment symbol 

a symbol given in ENTRY pseudo-op 

an EXTERNAL symbol 

an INTERNAL or ENTRY symbol 

a global symbol 

a label 

a local symbol 

a lefthalf relocatable symbol 

a macro name 

an undefined but referenced symbol 

numeric 

an opcode 

a symbol defined by OPDEF pseudo-op 

a symbol already in the symbol table 

a relocatable symbol 

a righthalf relocatable symbol 

a symbol (instead of a number) 

a symbol defined by SYN pseudo-op 



NOTE 

If the expression has different properties in 
Pass 1 and Pass 2, the number of words of code 
generated may be different for each pass. 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.IFN F00 f OPDEF , <OPDEF FOOC270B(33> 

Abbreviate qualifier up to unique initial letters. For 
example, OPCODE can be abbreviated to OPC, but not to 
OP, since OPDEF has the same first two letters. 

Omit the comma preceding the left angle bracket. 

.DIRECTIVE SFCOND, .IF, IFx group 

Omitting the comma between expression and qualifier. 

Mismatching angle brackets. 

Misplacing the .IFN statement in such a way that the 
property given by the qualifier is different in Pass 1 
and Pass 2. For example, the following code generates 
phase errors in Pass 2: 

. IFN F00 > OPDEF > < JFCL> 
OPDEF FOOrJRST] 

nxtlab: end 
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PSEUDO-OPS 



IFx group 



FUNCTION Gives criterion and code for conditional assembly. A 
symbol or expression used to define the conditions for 
assembly must be defined before MACRO reaches the 
conditional statement. If the value of such a symbol 
or expression is not the same on both assembly passes, 
a different number of words of code may be generated, 
and a phase error can occur. 

The forms of the IF pseudo-op are listed below; in the 
first six forms, n is the value of the given 
expression. 

IFE expression , <code> - assemble code if n=0. 

IFN expression ,<code> - assemble code if n^O. 

IFG expression, <code> - assemble code if n>0. 

IFGE expression, <code> - assemble code if n>0. 

IFL expression, <code> - assemble code if n<0. 

IFLE expression ,<code> - assemble code if n<0. 

IF1 <code> - assemble code on Pass 1. 

IF2 <code> - assemble code on Pass 2. 

IFDEF symbol ,<code> - assemble code if the symbol is 
defined as user-defined, an opcode, or a 
pseudo-op. 

IFNDEF symbol ,<code> - assemble code if the symbol is 
not defined as user-defined, an opcode, or a 
pseudo-op. Code is also assembled if the symbol 
has been referenced, but is not yet defined. This 
can occur during Pass 1. 

IFIDN <str inglXstr ing2> ,<code> - assemble code if the 
strings are identical. 

IFDIF <stringl><string2> ,<code> - assemble code if the 
strings are different. 

NOTES 

1. For IFIDN and IFDIF, the assembler 
compares the two strings (interpreted 
as ASCII) character by character. 

2. The IFIDN and IFDIF pseudo-ops usually 
appear in macro definitions, where one 
or both strings are dummy-arguments. 



(Continued on next page) 
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PSEUDO-OPS 



IFx group (Cont.) 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IFB <string>,<code> - assemble code if the string 
contains only blanks and tabs. 

IFNB <string> ,<code> - assemble code if the string does 
not contain only blanks and tabs. 

%%CC~~%%CCfl 5 Increment character count 
IFG %%CC-5r <%%CO=0 rUord overflowed? 
%%UO«%%UC+l> JYes> to next word 

Omit angle brackets enclosing code for single-line 
conditionals. 

Omit the comma preceding the code if the code is 
enclosed in angle brackets. 

For IFIDN, IFDIF, IFB, and IFNB only: use a nonblank, 
nontab character other than < as the initial and 
terminal delimiters for a string (as in pseudo-ops 
ASCII and ASCIZ) . You can then include angle brackets 
in the string. 

.DIRECTIVE SFCOND, .IF, . IFN 



Comparison string too large (A error). 

Mismatched angle brackets. 

EXTERNAL symbol used for comparison (E error) . 

String not properly delimited. 

Missing comma with single-line conditional. 
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PSEUDO-OPS 



INTEGER 



FORMAT 



FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



INTEGER symbol , ... , symbol 

symbol = the name of a location to be reserved. 

Reserves storage locations at the end of the program on 
a one-per-given-symbol basis. The symbols are 
equivalent to variable symbols. 

For a two-segment program, INTEGER storage must be in 
the low segment. 

INTEGER A»BrC 

Reserve a single storage location by suffixing a number 
sign (#) to a symbol in the operand field. For 
example , 

ADD 3 t TEMP* 

is equivalent to 

INTEGER TEMP 
ADD 3 r TEMP 

ARRAY, BLOCK, .COMMON, VAR 
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PSEUDO-OPS 



INTERN 



FORMAT 
FUNCTION 



INTERN symbol , . .., symbol 

Declares each given symbol to be INTERNAL global; 
therefore its definition, which must be in the current 
program, is available to other programs at load time. 
Each such symbol must be defined as a label, a 
variable, or a direct-assignment symbol. 

MACRO builds a list of symbol definitions that will be 
available to other programs at load time. 

OPDEF symbols can be declared INTERNAL, and thus be 
made available to other programs at load time. 
However, if the current program has another symbol 
(besides the OPDEF symbol) of the same name, the 
INTERNAL declaration will apply to that symbol rather 
than to the OPDEF symbol. 



EXAMPLES 

OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



INTERN SQUARE , CBROOT , TYPE2 



TAG: : 

VALUE= rexpression 

EXTERN, ENTRY 



; INTERNAL label 

; INTERNAL direct assignment 



COMMON 
ERRORS 



Failing to define an INTERNAL symbol in the current 
program. 

Using INTERN for a library entry point (when ENTRY is 
required) . 
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PSEUDO-OPS 



IOWD 



FORMAT 



FUNCTION 



EXAMPLES 



IOWD expl,exp2 

expl, exp2 = expressions. 

Generates one I/O transfer word in a special format for 
use in BLKI and BLKO and all five pushdown instructions 
(ADJSP, PUSH, POP, PUSHJ, POPJ) . The left half of the 
assembled word contains the 2's complement of the value 
of expl, and the 1 right half contains the value exp2-l. 

The following line shows how IOWD 6,~D256 places -6 
(octal 777772) in the left halfword and 256 (octal 377) 
in the right halfword: 



777772 000377 



IOWD 6,~D256 



The following lines show IOWD STL,STK used in a 
literal. The LIT pseudo-op then shows the code 
generated in the literal pool. 



000017 
000001 
000100 

200 17 00 001053' 
261 17 00 000001 
254 00 00 001054' 



pans 17 

STL==100 
stk: BLOCK STL 

MOVE FrCIOWD STL»STK3 
PUSH P»AC1 
JRST END 



777700 000001 

104 00 00 000170 



LIT 



end: haltf 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



XWD -expl,exp2-l 

-expl , ,exp2-l 

Using a relocatable expression for expl (R error) . 
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PSEUDO-OPS 



IRP 



FORMAT 



FUNCTION 



EXAMPLES 



IRP darg ,<code> 

darg = one of the dummy-arguments of the enclosing 
macro definition. (You can use IRP only in the 
body of a macro definition.) 

Generates one expansion of code for each subargument of 
the string that replaces darg. Each occurrence of darg 
within the expansion is replaced by the subargument 
currently controlling the expansion. (See Section 
5.6.) 

Concatenation and line continuation are not allowed 
across end-of-IRP, since a carriage return and linefeed 
are appended to each expansion. See the example below. 



000000 
000001 
000002 
000003 
000004 



201 02 00 000000 

140 02 00 000003 
140 02 00 000004 
140 02 00 000000 

202 02 00 000001 



LALL 
Z=0 

ANSWER-1 
0=2 

X=3 

Y=4 

DEFINE SUM<A>B)< 
MOVE I QrO 
IRP A><ADD 0» A!: 
MOVEM QtB 

SUM <<X> YrZ>t ANSWER)- 
MOVEI 0,0 
IRP 

ADD OrX 

ADD OfY 

ADD 0>Z 

MOVEM Or ANSWER 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IRPC, STOPI 

IRP NOT IN A MACRO (A ERROR) . 
Argument is not a dummy symbol (A error). 
Argument is a created symbol (A error). 
Mismatched angle brackets. 
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PSEUDO-OPS 



IRPC 



FORMAT 



FUNCTION 



EXAMPLES 



RELATED 
PSEUOD-OPS 

COMMON 
ERRORS 



IRPC darg,<code> 

darg = one of the dummy-arguments of the enclosing 
macro definition. (IRPC can only be used in the 
body of a macro definition.) 

Generates one expansion of code for each character of 
the string that replaces darg. Each occurrence of darg 
within the expansion is replaced by the character 
currently controlling the expansion. (See Section 
5.6.) 

Concatenation and line continuation are not allowed 

across end-of-IRPC, - since a carriage return and 

linefeed are appended to each expansion. See the 
example below. 



123 000 000 000 000 

124 000 000 000 000 
122 000 000 000 000 
111 000 000 000 000 
116 000 000 000 000 
107 000 000 000 000 

IRP, STOPI 



DEFINE A <B XI RFC B»<ASCIZ \BV 

A (STRING) "IRPC 

ASCIZ \S\ 

ASCIZ \T\ 

ASCIZ \R\ 

ASCIZ \I\ 

ASCIZ \N\ 

ASCIZ \G\ 



IRPC NOT IN A MACRO (A ERROR) . 
Argument is not a dummy symbol (A error). 
Argument is a created symbol (A error) . 
Mismatched angle brackets. 
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PSEUDO-OPS 



LALL 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



LALL 

Causes the assembler to print in the program listing 
file everything that is processed, including all text 
and macro expansions. Since XALL is the default, you 
must use LALL if you want full macro expansions listed. 
This can be helpful in debugging a program. 

LALL does not produce comments in a macro expansion if 
the comments are preceded by double semicolons (;;). 
This is because such comments are not stored. 

Use the /E switch described in Table 7-1. 



LIST, SALL, XALL, XLIST 
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PSEUDO-OPS 



.LINK 



FORMAT 



.LINK chain-number , store-address , chain-address 



chain-number = a positive integer expression that 
associates the link with others having the same 
number . 

store-address = a symbol giving the store address for 
this entry in the chain. 

chain-address = an optional integer expression giving 
the address of this entry in the chain. If you 
omit the chain-address, MACRO generates a and 
LINK uses the store-address as the chain-address. 



FUNCTION 



Generates static chains at load time. MACRO generates 
a REL Block Type 12. (See the LINK Reference Manual 
for a full discussion of LINK'S handling of these 
chains . ) 



EXAMPLES 



See the LINK Reference Manual (REL Block Type 12) for 
extensive examples of using .LINK and .LNKEND. 



RELATED 
PSEUDO-OPS 



.LNKEND 



COMMON 
ERRORS 



Chain-number not absolute (A error). 

EXTERNAL expression for store-address or chain-address 
(E error) . 
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PSEUDO-OPS 



LIST 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



LIST 

Resumes listing following an XLIST statement. The LIST 
function is implicitly contained in the END statement. 

Use the /L switch described in Table 7-1. 



RELATED 
PSEUDO-OPS 



LALL, SALL, XALL, XLIST 
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PSEUDO-OPS 



LIT 



FORMAT 
FUNCTION 



LIT 

Assembles literals beginning at the current address. 
The literals assembled are those found since the 
previous LIT, or since the beginning of the program, 
whichever is later. The location counter is 
incremented by 1 for each word assembled. 



In a PSECTed program, LIT assembles only literals 
the current PSECT. 



in 



A literal found after the LIT is not affected. It will 
be assembled at the next following LIT, or at the END 
statement, whichever is J earlier. 

At the END statement, unassembled literals are placed 
in open-ended storage after the end-of-program. If 
data is also to be entered in open-ended storage, 
literals stored there may be overwritten. (See 
Appendix F for a discussion of storage allocation.) 
This possibility is avoided by using LIT before the END 
statement. 

Assembling literals with LIT also produces a listing of 
their binary code. Literals unassembled at the END are 
XLISTed. 

Literals having the same value are collapsed in MACRO'S 
literal pool. Thus for the statements: 

PUSH FfZOl 
PUSH PtZOl 
MOVEI AClrCASCIZ /TEST.l/3 

the same address is shared by the two literals [0] , and 
by the null word generated at the end of [ASCIZ 
/TEST1/] . Literal collapsing is suppressed for those 
literals that contain errors, undefined expressions, or 
EXTERNAL symbols. 



NOTES 



If the code immediately preceding a LIT 
does not cause a transfer of execution 
control to some other location, execution 
will "fall into" the literal pool, 
producing unpredictable results. 

In a file containing PRGEND pseudo-ops, 
only one LIT is permitted in each module 
before the last one. The last module 
(containing the END statement) , or any file 
without PRGENDs , can contain multiple LITs. 



(Continued on next page) 
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PSEUDO-OPS 



LIT (Cont.) 



EXAMPLES 



RELATED 
PSEUDO-OPS 



400046' 200 00 00 400050' 

400047' 047 00 00 000041 

400050' 

400050' 000001 000003 



move: o»cxud i>3::i 

GETTAB 0> 
LIT 



.DIRECTIVE LITLST, END, PRGEND, VAR 



COMMON 
ERRORS 



Assembling literals so that some are collapsed on Pass 
1, but not on Pass 2. For example, in the following 
lines, the literals [A] and [B] are collapsed on Pass 1 
since they have the same value; but on Pass 2 their 
values are different and they are not collapsed. This 
produces a phase error for the label FOO. 

IF1»<A=5 

IF2»<A=5 

B=4> 
MOVE AC»CA3 
MOVE AC » LB 3 
LIT 
FOOJ 

However, literals that have different values in Pass 1 
but the same value in Pass 2 do not produce a phase 
error. For example, the following code generates two 
words of literal storage in Pass 1. During Pass 2 the 
values of [A] and [B] are collapsed, but nevertheless 
MACRO generates two words of literal storage to avoid a 
phase error at the label FOO. 

MOVE AClrllA: 

MOVE AC1»CB3 

LIT 

A=5 

B--=5 

foo: 
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PSEUDO-OPS 



.LNKEND 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



. LNKEND chain-number , store-address 

Ends a static chain generated at load time. See the 
LINK Reference Manual (REL Block Type 12) for extensive 
examples of using .LINK and .LNKEND.) 

.LINK 



Chain-number not absolute (A error) . 

EXTERNAL expression for store-address (E error) . 
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PSEUDO-OPS 



LOC 



FORMAT 



LOC expression 

expression = an optional operand whose value gives the 
address at which sequential address assignment is 
to continue. 



FUNCTION 



Sets the location counter to the value of the 
expression and begins assigning absolute addresses to 
the instructions and data following the LOC 
instruction. 



If no address is specified, the location counter is 
restored to its value previous to the last LOC 
pseudo-op or RELOC-RELOC sequence. (See example 
below.) If no previous LOC pseudo-op was encountered, 
the assumed address is 0. 

To switch to relocatable address mode, use the 
pseudo-op RELOC. If no argument is specified, RELOC 
(in this context) restores the location counter to its 
value previous to the LOC pseudo-op or LOC-LOC 
sequence. (An implicit RELOC begins each program.) 

If an entire program is to be assigned absolute 
locations, a LOC statement must precede all 
instructions and data. 

Note that, unlike RELOC-RELOC sequences, typically used 
to switch between segments in a two-segment program, 
LOC-LOC sequences cannot be successfully interrupted 
and then resumed. This is demonstrated in the example 
below. 



EXAMPLES 



400000' 






TWOSEG 400000 


000000' 






RELOC 


000010 






LOC 10 


000010 


000000 


000001 


DEC If 2 


000011 


000000 


000002 




000100 






LOC 100 


000100 


000000 


000003 


DEC 3r4 


000101 


000000 


000004 




000012 






LOC 


000102 






LOC 


000000' 






RELOC 


JBut we 


can't resume LOC 


-LOC 


400000' 






RELOC 


000102 






LOC 


000102 






LOC 


400000' 






RELOC 


000.102 






LOC 



J Set up hi sea 
fBack to lowses! 
?Set up LOC-LOC 



r Resume RELOC- 
5 RELOC 



J But RELOC- 

y RELOC is fine 



RELATED 
PSEUDO-OPS 



RELOC, .ORG, TWOSEG 



COMMON 
ERRORS 



Using an EXTERNAL expression for the address expression 
(E error) . 
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PSEUDO-OPS 



.MFRMT 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



.MFRMT 

Causes multiformat listing of binary code. The type of 
instruction assembled determines this format. (See 
Section 6.1.) .MFRMT is the default setting. 

Use the /F switch described in Table 7-1. 



.HFRMT 
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PSEUDO-OPS 



MLOFF 



FORMAT 
FUNCTION 

EXAMPLES 



MLOFF 

Terminates each literal at end-of-line even if no 
closing square bracket is found. This pseudo-op is 
intended only to maintain compatibility of programs 
written for very old versions of MACRO. 

This example shows how MLOFF can be used to interpret 
[1234 as [1234] . 



000000 
000000 



402001' 
40200 r ' 



MLOFF 
C1234 
C1234D 



OPTIONAL 
NOTATIONS 



Use the /0 switch described in Table 7-1 



RELATED 
PSEUDO-OPS 



MLON 
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PSEUDO-OPS 



MLON 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



MLON 

Suspends the effect of an earlier MLOFF pseudo-op, 
thereby enabling the use of multiline literals. MLON 
is the default setting. 

MLOFF 
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PSEUDO-OPS 



.NODDT 



FORMAT 
FUNCTION 

EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.NODDT symbol, ... , symbol 

Suppresses debugger output of each given symbol. Each 
symbol must have been previously defined. Symbols 
suppressed with .NODDT can include OPDEF symbols. 

♦NODDT CALLrPJRST,P 

Use == for direct-assignment symbols. (See Section 
2.4.2.2.) 

Use :! for label symbols. (See Section 2.4.2.1.) 

PURGE 



Using .NODDT with an undefined symbol argument. 
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PSEUDO-OPS 



NOSYM 



FORMAT 
FUNCTION 



NOSYM 

Suppresses listing of the symbol table in the program 
listing file. 

Suppressing the listing of symbol tables is useful for 
a library file containing many PRGENDs. 
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PSEUDO-OPS 



OCT 



FORMAT 
FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



OCT expression , ... , expression 

Defines the local radix for the line as octal; the 
value of each expression is entered in a fullword of 
code. The location counter is incremented by 1 for 
each expression. 



OCT 1,2,20,100 



000000 000001 

000000 000002 

000000 000020 

000000 000100 



Use the EXP pseudo-op and prefix "0 to each expression 
that roust be evaluated in radix 8. In the example 
above, only the third and fourth expressions, "20,100," 
could have different evaluations in different radixes. 
Therefore an equivalent notation is: 



000000 000001 

000000 000002 

000000 000020 

000000 000100 

DEC, EXP, RADIX 



EXP 1 »2 > "020 » ~0100 
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PSEUDO-OPS 



OPDEF 



FORMAT 
FUNCTION 



OPDEF symbol [expression] 

Defines the symbol as an operator equivalent to 
expression, giving the symbol a fullword value. When 
the operator is later used with operands, the 
accumulator fields are added, the indirect bits are 
ORed , the memory addresses are added, and the index 
register addresses are added. 

An OPDEF can be declared INTERNAL, using the INTERN 
pseudo-op. However, if a symbol of the same name 
exists, the INTERNAL declaration will apply only to 
that symbol, and not to the OPDEF. 



NOTES 



If you use a relocatable symbol in defining 
an OPDEF, the value of the symbol may not 
be the same for all references to the 
OPDEF. 

Though the expression portion of an OPDEF 
must be in square brackets, this use of the 
brackets is completely unrelated to 
literals or literal handling. 



EXAMPLES 



200062 000010 
200 02 1 04 000014 



OPDEF CAL CMOVE 1 ,(?SYM< 2) 3 
CAL 1,B0L<2> 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



The CAL statement is equivalent to: 

200 02 1 04 000014 MOVE 2rBSYM+B0L<4) 

DEFINE, SYN 

OPDEF of macroname or SYN symbol (A error). 

No code generated by statement in square brackets (A 
error) . 

Missing square brackets (A error). 
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PSEUDO-OPS 



.ORG 



FORMAT 
FUNCTION 



.ORG address 

Sets the location counter to the address and causes the 
assembler to assign absolute or relocatable addresses 
depending on the mode of the argument. If A is 
relocatable, then .ORG A is equivalent to RELOC A; if 
A is absolute, then .ORG A is equivalent to LOC A. 

.ORG with no address sets the location counter to the 
value it had immediately before the last LOC, RELOC, or 
.ORG. 



EXAMPLES 



400000' RELOC 400000 

400000' RELAOi: 

000000' RELOC 

000000' RELAD2: 

000100 LOC 100 

000100 ABSAEH. 

400100 LOC 400100 

400100 ABSAD2. 

000100 LOC ABSAD1 



J Set up some labels 



400000' 



400100 



400000' 



000000' 



400000' 



000000' 



RELOC RELAD1 



♦ORG ABSAD2 



.ORG 



♦ORG RELAD2 



♦ ORG 



.ORG 



Set counter to ABSAD1 
and bed in absolute 
address assignment. 

Set counter to RELAD1 
and begin relative 
address assignment. 

Set counter to ABSAD2 
and bed in absolute 
address assignment ♦ 

Set counter to value 
immediately before 
last LOC* RELOCy or 
♦0RG> and bed in 
address assignment 
in appropriate mode* 

Set counter to RELAD2 
and bed in absolute 
address assignment. 

Set counter to value 
immediately before 
last LOCf RELOC > or 
. 0RG» and bed in 
address assignment 
in appropriate mode. 

Set counter to value 
immediately before 
last L0C> RELOCf or 
♦ORG* and begin 
address assignment 
in appropriate mode. 



RELATED 
PSEUDO-OPS 



LOC, RELOC, TWOSEG 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
for the address expression. 
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PSEUDO-OPS 



PAGE 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



PAGE 

Causes the assembler to list the current line and then 
skip to the top of the next listing page. The subpage 
number is incremented, but the page number is not. 

A formfeed character (CTRL/L) in the input text 
has a similar effect, but increments the page number 
and resets the subpage number. 
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PSEUDO-OPS 



PASS 2 



FORMAT 
FUNCTION 



EXAMPLES 



PASS2 

Switches the assembler to Pass 2 processing for the 

remaining code. All code preceding this statement will 

have been processed by Pass 1 only; all following code 
by Pass 2 only. 

You can use PASS2 to reduce assembly time during 
debugging; you can also use PASS2 to omit the second 
pass for a UNIVERSAL file containing only symbol 
definitions (OPDEFs, macros, and direct assignments). 

Testing a macro defined in the Pass 1 portion: 



IFE NON, 



PRINTX 7H0RRIBLE ERROR 

PASS2 

END 



stops assembly if NON = 0. 
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PSEUDO-OPS 



PHASE 



FORMAT 



PHASE address 



FUNCTION 



address = an integer expression; 
symbol . 



cannot be an EXTERNAL 



Assembles pa 
other locat 
the subrouti 
or absolute 
program, but 
is PHASE, fo 
of the block 
prior to e 
subroutine a 
The subrouti 
the location 



rt of a program so that it can be moved to 

ions for execution. To use this feature, 

ne is assembled at sequential relocatable 

addresses along with the rest of the 

the first statement before the subroutine 
llowed by the address of the first location 

into which the subroutine is to be moved 
xecution. All address assignments in the 
re in relation to the address argument, 
ne is terminated by DEPHASE, which restores 

counter . 



EXAMPLES 



In the following example, which is the central loop in 
a matrix inversion, a block transfer instruction moves 
the subroutine LOOP into accumulators 11 to 15 for 
execution. (This results in faster execution on KA10 
and KI10 processors.) 



002000' 200 00 00 402002'MAINt MOVE CXWD LOOPXrLOOPU 



002001' 

002002' 

000011 

000011 

000012 

000013 

000014 

000015 

002010' 



251 00 00 000015 



BLT L00P+4 
JRST LOOP 



254 00 00 000011 

LOOPX: PHASE 11 

210 02 03 000002 LOOP: MOVN AC>A(X> 

160 02 00 000100 FMP ACMPYR 

142 02 04 000002 FADM AC>A(Y) 

365 03 00 000011 SOJGE Xr»~3 

254 00 00 002000' JRST MAIN 

DEPHASE 



RELATED 
PSEUDO-OPS 



The label LOOP represents accumulator 11, and the .-3 
in the SOJGE instruction represents accumulator 11. 

Note that the code inside the PHASE-to-DEPHASE program 
segment is loaded into the address following the 
previous relocatable code; all labels inside the 
segment, however, have the address corresponding to the 
phase address. Thus the phased code, if it contains 
control transfers other than skips, cannot be executed 
until it has been moved (for example, by a BLT 
instruction) to the address for which it was assembled. 

DEPHASE 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address (E error). 
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PSEUDO-OPS 



POINT 



FORMAT 
FUNCTION 



POINT bytesize, address ,bitplace 

Generates a byte pointer word for use with the machine 
language mnemonics ADJBP, LDB, IBP, ILDB, and IDBP. 

Bytesize gives the decimal number of bits in the byte, 
and is assembled in bits 6 to 11 of the storage word. 
Address gives the location of the byte word, and is 
assembled in bits 13 to 35. Bitplace gives the 
position (in decimal) of the rightmost bit of the byte. 
MACRO places the value 35 minus bitplace in bits to 5 
of the storage word. 

If the address is indirect, bit 13 is set. If the 
address is indexed, the index is placed in bits 14 to 
17. The default bytesize is 0. The default bitplace 
is -1, so that the byte increment instructions IBP, 
ILDB, and IDBP will begin at the left of the address 
word . 



EXAMPLES 



36 06 00 000000 
44 06 00 000100 



POINT 6t0rS 
POINT 6fl00 



COMMON 
ERRORS 



Bytesize or bitplace not given in decimal. 
Bytesize or bitplace not absolute. 
Bytesize or bitplace EXTERNAL. 
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PSEUDO-OPS 



PRGEND 



FORMAT 
FUNCTION 



PRGEND 

Replaces the END statement for all except the last 
program of a multiprogram assembly. PRGEND closes the 
local symbol table for the current module. 

You can use PRGEND to place several small programs into 
one file to save space and disk accesses. The 
resulting binary file can be loaded in search mode. 
(See the LINK Reference Manual .) 

Using PRGEND requires extra memory for assembly, since 
the tables for each program must be saved for Pass 2. 
Functionally, however, PRGEND is identical to END, 
except that PRGEND does not end the current assembly 
pass. 



NOTE 



1. PRGEND is not allowed in macros or PSECTs. 

2. PRGEND clears the TWOSEG pseudo-op. 

3. Like END, PRGEND causes assembly of all 
unassembled literals and variable symbols. 

4. In a file containing PRGENDs , using more 
than one LIT pseudo-op in any but the last 
program produces unpredictable results. 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Give an argument with PRGEND, specifying the start 
address for the program. See the END pseudo-op for a 
discussion of this argument and its meaning. 

END, LIT, VAR 



Failing to end a text string, REPEAT, conditional code, 
DEFINE, or literal with a closing delimiter; MACRO 
cannot see any following PRGEND or END. 

Confusing multiprogram and multifile assemblies. A 
multiprogram assembly involves multiple programs 
separated by PRGENDs. A multifile assembly always 
involves multiple files separated by end-of-file. The 
two types of assemblies are not mutually exclusive. 
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PSEUDO-OPS 



PRINTX 



FORMAT 
FUNCTION 



EXAMPLES 



PRINTX text 

Causes text to be output during assembly. On Pass 1 
the text is output to the terminal and the listing 
device. On Pass 2 the text is output to the terminal, 
but only if the terminal is not the listing device. 

PRINTX is frequently used to output conditional 
information and, in very long assemblies, to report 
progress of the assembler through Pass 1. 

PRINTX ASSEMBLER HAS REACHED POINT NOWGO 



IFGE ♦ -1000»<PRINTX CODE MORE THAN IP!: 
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PSEUDO-OPS 



.PSECT 



FORMAT 



FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 



.PSECT name/attribute , or igin 

name = a valid symbol giving the name of the PSECT. 

attribute = either CONCATENATE or OVERLAID. 

origin = an expression giving an address for the PSECT 
origin. 

Specifies the relocation counter to be used for the 
code following. MACRO generates a REL Block Type 23. 
(See the LINK Reference Manual .) 

Do not use PRGEND and .PSECT in the same file. MACRO 
will treat the first PRGEND as an END statement and 
ignore any following source code. 

For a complete discussion of PSECTS and their handling, 
see Section 9.1.3. 

♦PSECT A/CONCATENATE ,0 

♦PSECT FIRST/QVERLAIDrlOOO 

Omit attribute (defaults to CONCATENATE). 

.ENDPS, LOC, .ORG, RELOC, TWOSEG 

Using TWOSEG and .PSECT in the same module. 
Using HISEG and .PSECT in the same module. 
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PSEUDO-OPS 



PURGE 



FORMAT 



FUNCTION 



PURGE symbol, , symbol 

symbol = an assigned symbol, a label, an operator, or a 
macro name. 

Deletes symbols from the symbol tables. Normally used 

at the end of a program to conserve storage and to 

delete symbols for the debugger. Purged symbol table 
space is reused by the assembler. 

If you use the same symbol for both a macro name or 
OPDEF and a label, a PURGE statement deletes the macro 
name or OPDEF. Repeating the instruction then purges 
the label. 

Purging a symbol that is EXTERNAL or undefined 
suppresses any error messages associated with it. 



EXAMPLES 



000040 000001 



label: \,i 
purge label 



RELATED 
PSEUDO-OPS 



.NODDT, XPUNGE 
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PSEODO-OPS 



RADIX 



FORMAT 



FUNCTION 



RADIX expression 

expression = decimal value from 2 to 10 

Sets the radix to the value of expression. An implicit 
RADIX 8 statement begins every MACRO program. 

All numerical expressions that follow (up to the next 
RADIX pseudo-op) are interpreted in the given radix 
unless another local radix is indicated. (A different 
local radix for the line can be indicated by the DEC or 
OCT pseudo-ops; a different local radix for an 
expression can be indicated by *B f "D, or "0. See 
Section 2.2.2.) 

Ordinarily, numbers outside the range of the given 
radix are not interpreted. For example, in radix 8, 
the number 99 causes an error. However, a single-digit 
number is interpreted in any case. For example, in 
radix 8, the number 9 is recognized as octal 11. 



EXAMPLES 



000000 000012 
000000 000010 



RADIX 10 
EXP 10 
RADIX 8 
EXP 10 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Use one of the following prefixes to change the radix 
for a single expression: *B for binary, "0 for octal, 
""D for decimal, 

DEC, OCT 



Using a relocatable expression (A error) . 

Using an external expression (E error) . 

Giving a radix argument not in the range 2 to 10 
decimal (A error) . 

Misusing numbers in a given radix; for example, in the 
statements 

RADIX 10 
RELOC 400000 

MACRO treats the number 400000 as decimal. 



3-55 



PSEUDO-OPS 



RADIX50 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RADIX50 code, symbol 

Packs the symbol into bits 4 to 35 of the storage word, 
with the code in bits to 3. 

The "50" in RADIX50 is octal, so that the radix in 
decimal is 40. The 40 characters permitted in symbols 
are the "digits" of the RADIX50 symbol expression. 
Thus a symbol is seen by RADIX50 as a "6-digit" number 
in base 40, converted to binary, and placed in bits 4 
to 35 in storage. 

The code expression for RADIX50 is a number in the 
range to 74 octal. Its binary equivalent should end 
with two zeros (that is, the octal should end with or 
4), since the two low-order bits will not be stored. 
The four high-order bits are placed in bits to 3 in 
storage . 

See Appendix A for the octal values of RADIX50 
characters. 

126633 472376 RADIX50 lOrSYMBQL 
466633 472376 RADIX50 44rSYMB0L 

The mnemonic SQUOZE can be used in place of RADIX50. 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



RADIX50 , symbol (code is taken as zero) . 
SQUOZE 

RADIX50 code not absolute (A error). 

RADIX50 code does not end with or 4 (Q error) . 
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PSEUDO-OPS 



RELOC 



FORMAT 



RELOC expression 

expression = an optional operand that specifies the 
address at which sequential address assignment is 
to continue. 



FUNCTION 



Sets the location counter to the value of expression, 
and begins assigning relocatable addresses to the 
instructions and data that follow. 



In a PSECTed program, RELOC sets the location counter 
for the current PSECT. 

If no address is specified, the location counter is 
restored to its value before the last RELOC, or before 
the last LOC-LOC sequence, whichever is later. (See 
the first example below.) If no previous RELOC or 
LOC-LOC sequence was encountered, the location counter 
is set to 0. 

An implicit RELOC begins every MACRO program. To 
switch to absolute address mode, use the pseudo-op LOC. 

Note that RELOC-RELOC * sequences (typically used to 
switch between segments in a two-segment program) can 
be interrupted and then resumed. This is demonstrated 
in the first example below. 



EXAMPLES 



400000' 

000000' RELOC 

000000' 000000 000001 DEC 1>2 

000001' 000000 000002 

400000' RELOC 

400000' 255 00 00 000000 JFCL 

000137 LOC 137 



TWOSEG 400000 rSet up hisesl 



000137 000100 000001 
400001' 



XWD 100.1 
RELOC 



400001' 254 00 00 400000' JRST 
000002' RELOC 



JBack to lowsed 



JBack to hisesf 

J Deposit version 
r in absolute 137 

iBack to hise3 
r where left off 

rBack to lowse£ 



RELATED 
PSEUDO-OPS 



LOC, .ORG, TWOSEG 



(Continued on next page) 
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PSEUDO-OPS 



RELOC (Cont.) 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address. 



Returning to the wrong segment when using RELOC with 
TWOSEG. The last four lines of the following example 
show how this can occur: 



400000 ' 
400000' 



000000' 

400000' 

400000' 000000 
400001' 000000 
000000' 

000000' 000000 
000001' 000000 
400002' 
400000' 



000001 
000002 

000003 
000004 



TUOSEG 

RELOC 400000 rSets first RELOC 
i counter to 

; 400000' 

RELOC f Saves 400000 ', 

i sets to 000000' 
RELOC r Swaps counters 
EXP lr2 i Enter values here 



RELOC 
EXP 3r4 

RELOC 



fSwaps again 
?More values here 

rSwaps again 



RELOC 400000 J Lost counter 
r to 000002' 



400002' 




RELOC 


r Swaps adain 


400000' 




RELOC 


r Swaps again 


400000' 000000 


000001 


EXP 1 


rOverwrites 400000' 
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PSEUDO-OPS 



REMARK 



FORMAT 

FUNCTION 

EXAMPLES 

OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



REMARK text 

Text is a comment. 

REMARK I CAN SAY ANYTHING HERE* 

A comment line can also begin with a semicolon 

COMMENT 



Continuing REMARK text to next line without using the 
continuation character (CTRL/underscore) . 
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PSEUDO-OPS 



REPEAT 



FORMAT 



FUNCTION 



EXAMPLES 



REPEAT expression , <code> 

expression = the repeat index, which gives the number 
of times to repeat assembly of the code given; 
the repeat index can be any expression having a 
nonnegative integer value. 

Generates the code given in angle brackets n times. 
REPEAT statements can be nested to any level. 

Line continuation is not allowed across end-of-REPEAT, 
since a carriage return and linefeed are appended to 
each expansion of the code. 

Note that REPEAT 0,<code> is logically equivalent to a 
false conditional, and REPEAT l,<code> is logically 
equivalent to a true conditional. 

000000 C0UNT=0 
TABLE: REPEAT 4><C0UNT> 
C0UNT=C0UNT+1> 

002020' 000000 000000 COUNT 

000001 C0UNT=C0UNT+1 
002021' 000000 000001 COUNT 

000002 COUNT-COUNT+1 
002022' 000000 000002 COUNT 

000003 C0UNT=C0UNT + .l 
002023' 000000 000003 COUNT 

000004 C0UNT=C0UNT+1 



REPEAT 3r 



002024' 000000 002024' 
002025' 000000 002025' 
002026' 000000 002026' 



RELATED 
PSEUDO-OPS 



DEFINE, IRP, IPRC 



COMMON 
ERRORS 



No comma after n (A error) . 

Using an EXTERNAL symbol or complex EXTERNAL expression 
as the repeat index. 

Mismatching angle brackets. 
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PSEUDO-OPS 



.REQUEST 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



.REQUEST filespec 

Causes the specified file to be loaded only to satisfy 

a global request; that is, the file is loaded in 

library search mode. (See Chapter 7 for a discussion 
of files.) 

The filespec must not include a file extension. If you 
specify a path, only the project-programmer number is 
allowed; SFDs are not allowed. 

MACRO generates a REL Block Type 17. (See the LINK 
Reference Manual . ) 

♦REQUEST DSK: MACROS 
.REQUEST MACROS 

DSK: is the default device. 

Your default path at load time is the default path. 

.REQUIRE, .TEXT 
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PSEUDO-OPS 



.REQUIRE 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



.REQUIRE filespec 

Causes the specified file to be loaded automatically, 
independent of any global requests. (See Chapter 7 for 
discussion of files.) 

The filespec must not include a file extension. If you 
specify a path, only the project-programmer number is 
allowed; SFDs are not allowed. 

MACRO generates a REL Block Type 16. (See the LINK 
Reference Manual . ) 

♦REQUIRE DSKt MACROS 
♦REQUIRE MACROS 
♦REQUIRE SYSJMACREL 

DSK: is the default device. 

Your default path at load time is the default path. 

.REQUEST, .TEXT 



3-62 



PSEUDO-OPS 



SALL 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



SALL 

Causes suppression of all macro and repeat expansions 
and their text; only the input file and the binary 
generated will be listed. SALL can be nullified by 
either XALL or LALL. Using SALL generally produces the 
tidiest listing file. 

Use the /M switch described in Table 7-1. 



LALL, LIST, XALL, XLIST 
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PSEUDO-OPS 



SEARCH 



FORMAT 
FUNCTION 



EXAMPLES 



SEARCH tablename (filename) , . . . , tablename (filename) 

Defines a list of symbol tables for MACRO to search if 
a symbol is not found in the current symbol table. A 
maximum of ten tables can be specified. Tables are 
searched in the order specified. 

When the SEARCH pseudo-op is seen, MACRO checks its 
internal UNIVERSAL table for a memory-resident 
UNIVERSAL of the specified name. (See the UNIVERSAL 
pseudo-op for further discussion of memory-resident 
UNIVERSAL tables and use of the /U switch.) 

If no such entry is found in the UNIVERSAL table, MACRO 
reads in the symbol table using the given file 
specification. If no file specification is given, 
MACRO reads tablename .UNV from the default path. If no 
such file is found, MACRO then tries UNV: tablename .UNV 
and SYS : tablename .UNV, in that order. 

When all the specified files are found, MACRO builds a 
table for the search sequence. If MACRO cannot find a 
given symbol in the current symbol table, the UNIVERSAL 
tables are searched in the order specified. When the 
symbol is found, it is moved into the current symbol 
table. This procedure saves time (at the expense of 
core) on future references to the same symbol. 

A UNIVERSAL file can search other UNIVERSAL files, 
provided all names in the search list have been 
assembled . 

The internal table of UNIVERSAL names is cleared on 
each run (.R MACRO) or START command, but is not 
cleared when MACRO responds with an asterisk. 

In a PSECTed program, all UNIVERSAL symbols belong to 
the blank PSECT. 

SEARCH MONSYMrMACSYM 



OPTIONAL Omit the filename and its enclosing parentheses. MACRO 
NOTATIONS then looks on DSK : , UNV:, and SYS: (in that order) for 
tablename .UNV. 



RELATED 
PSEUDO-OPS 



UNIVERSAL 



COMMON 
ERRORS 



Not purging a macro that redefines itself (P error). 
If a macro is found in a universal file, the definition 
is copied into the current macro table and the 
auxiliary table is not searched on Pass 2. Thus, a 
macro that redefines itself can cause P errors similar 
to enclosing the macro by IF1. Such macros should be 
purged before Pass 2. 
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PSEUDO-OPS 



SIXBIT 



FORMAT 



FUNCTION 



EXAMPLES 



SIXBIT dtextd 

d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

Enters strings of text characters in 6-bit format. Six 
characters per word are left justified in sequential 
storage words. Any unused bits are set to zero. 

Lowercase letters in SIXBIT text strings are treated as 
uppercase. Otherwise, only the SIXBIT character set is 
allowed. (See Appendix A for SIXBIT characters and 
their octal codes.) 



64 45 70 64 00 63 
64 62 51 56 47 00 



SIXBIT \TEXT STRINGS 



644570 640000 



EXP SIXBIT /TEXT/ 



OPTIONAL Omit the space or tab after SIXBIT. This is not 
NOTATIONS allowed if the delimiter is a letter, number, dot, 
dollar sign, or percent sign (that is, a possible 
symbol constituent), or if the ASCII value of the 
delimiter character is less than 040 or greater than 
172. 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Right-justified SIXBIT can be entered by using single 
quotes to surround up to six characters; for example, 

006251 475064 'RIGHT' 

ASCII, ASCIZ, .DIRECTIVE FLBLST 

Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter). 

Using more than six characters in a right-justified 
SIXBIT string, or more than three characters if in the 
address field (Q error) . 

Using non-SIXBIT characters in the text string. 
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PSEUDO-OPS 



SQOOZE 



FORMAT 

FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
Errors 



SQUOZE code , symbol 

SQUOZE is a mnemonic for RADIX50. 

126633 472376 RADIX50 10 r SYMBOL, 
126633 472376 SQUOZE lOrSYMBOL 

RADIX50 code, symbol 

SQUOZE , symbol (code is taken as 0) . 

RADIX50 

Code not absolute (A error). 

Code does not end with or 4 (Q error) 
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PSEUDO-OPS 



STOPI 



FORMAT 
FUNCTION 



EXAMPLES 



STOPI 

Ends an IRP or IRPC before all subarguments or 
characters are used. The current expansion is 
completed, but no new expansions are started. STOPI 
can be used with conditionals inside IRP or IRPC to end 
the repeat if the given condition is met. 

LALL 

DEFINE ONETWOCAX 

IRP A f <IFIDN<AXONE> ? <STOPI 

EXP 1» 
I RP A t < I F I DN<AXTWO> , <STOP I 
EXP 2» 

ONETWO <A»B»D>~ 

IRP 
IFIDN<AXQNE> , <STOPI 



I F I DN<BXONE> f <STOP I 
IFIDN<DXONE> , <STOPI 

IRP 
I F I DN< AXT W0> t <STOP I 

IFIDN<BXTWO> , <STOPI 

I F I DN<DXTWO> f <STOP I 



EXP 1> 
EXP 1> 
EXP i> 

EXP 2> 
EXP 2> 
EXP 2> 



000000 000001 



ONETWO <A,ONE»BrONErTWO>~ 

IRP 
IFIDN<AXONE> , <ST0PI 



IFIDN<0NEX0NE> f <ST0PI 

IRP 
IFIDN<AXTWO> , <ST0PI 

IFIDN<0NEXTW0> r <ST0PI 

I F I D N < B > < TWO > f < STOPI 

IFIDN<0NEXTW0> , <ST0PI 

IFIDN<TW0XTW0> ? <ST0PI 



000000 000002 



EXP 1> 
EXP 1> 

EXP 2> 
EXP 2> 
EXP 2> 
EXP 2> 
EXP 2> 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IRP, IRPC 



STOPI not inside IRP or IRPC 
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PSEUDO-OPS 



SUBTTL 



FORMAT 

FUNCTION 



SUBTTL subtitle 

Defines a subtitle (of up to 80 characters) to be 
printed at the top of each page of the listing file 
until the end-of-listing or until another SUBTTL 
statement is found. 

The initial SUBTTL usually appears on the second line 
of the first page of the input file, immediately 
following the TITLE statement. 

For subsequent SUBTTL statements, the following rule 
applies: if the new SUBTTL is on the first line of a 
new page, then the new subtitle appears on that page; 
if not, the new subtitle appears on the next page. 



The statements 



♦ ♦ ♦ 



NOTE 



PRGEND 
TITLE F00 
SUBTTL BAR 

do not cause BAR to appear as the subtitle on 
the first page of the listing of FOO. 



EXAMPLES 

RELATED 
PSEUDO-OPS 



SUBTTL affects only the listing file, and subtitles can 
be changed as often as desired. 

SUBTTL THIS SECTION CONTAINS DEVICE-DEPENDENT ROUTINES 

TITLE 
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PSEUDO-OPS 



SUPPRESS 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



SUPPRESS symbol, ... , symbol 

Turns on a suppress bit in the symbol table for the 
specified symbols. The suppress bit will be turned off 
for any symbol later referenced in the program. 
Symbols whose suppress bits are on at the end of 
assembly are not listed in the symbol table, but will 
be listed in any tables built by CREF unless they are 
XCREFed. 

When an appended parameter file (as opposed to a 
UNIVERSAL file) is used in an assembly, many symbols 
may be defined but never used. These take up space in 
the binary file and complicate listing of the file. 

Unused and unwanted symbols can be removed from tables 
by SUPPRESS or ASUPPRESS . These pseudo-ops control the 
suppress bit in each entry of the symbol table; if the 
bit is on, the symbol in that location is not output. 

ASUPPRESS 



Attempting to suppress an undefined symbol. 
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PSEUDO-OPS 



SYN 



FORMAT 



FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



SYN syml,sym2 

syml = a defined symbol. 

sym2 = a symbol to be defined as synonymous with syml. 

Defines sym2 as synonymous with syml. 

If syml is defined as both a label and an operator, 
sym2 assumes the label definition. 

The following are legal SYN statements: 

SYN XfK 
SYN FAD > Attn 
SYN ENDrXEND 

To turn XLIST into a null operator, 

DEFINE ,XL < 
SYN .XL>XLIST 

To restore its operation, 

PURGE XLIST 

DEFINE, OPDEF 

Missing symbol (A error). 

Unknown symbol - first operand not defined (A error). 

Missing comma (A error) . 

Using a variable as one of the symbol arguments (A 
error) . 
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PSEUDO-OPS 



TAPE 



FORMAT 
FUNCTION 

EXAMPLES 



TAPE 

Causes the assembler to begin assembling the program 
contained in the next source file in the MACRO command 
string . 

(Interactive) 

♦ R MACRO 

*DSK t B I NAME » LPT : *TT Y : r DSK I MORE 

PARAM«6 

TAPE 

J THIS COMMENT WILL BE IGNORED 

"Z 

This sets PARAM to 6 and assembles the remainder of the 
program from the source file DSK:MORE. Since MACRO is 
a two-pass assembler, the TTY: file must be repeated 
for Pass 2. 

CMCREP1 END OF PASS 13 

PARAM=6 

TAPE 

~Z 

Note that all text after the TAPE pseudo-op is ignored. 
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PSEUDO-OPS 



TEXT 



FORMAT 



.TEXT dtextd 



FUNCTION 



d = delimiter; first nonblank character, whose 
appearance terminates the text. 



second 



Generates an ASCIZ REL Block Type for LINK and inserts 
the text string directly into the .REL file output as a 
separate block. (See the LINK Reference Manual .) 

The text inserted in the .REL file is interpreted as a 
command string for LINK. Therefore a MACRO program 
loaded by user commands to LINK can contain additional 
LINK commands, carried out when the MACRO program is 
loaded . 



EXAMPLES 



.TEXT '/SETJ.HIGH. J500000' 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



Omit the space or tab after .TEXT. This is not allowed 
if the delimiter is a letter, number, dot, dollar sign, 
or percent sign (that is, a possible symbol 
constituent) , or if the ASCII value of the delimiter 
character is less than 040 or greater than 172. 

.REQUEST, .REQUIRE 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 
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PSEUDO-OPS 



TITLE 



FORMAT 
FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



TITLE title 

Gives the program name and a title to be printed at the 
top of each page of the program listing. 

The first characters (up to six characters, or up to 
the first non-RADIX50 character) are the program name. 
This name is used when debugging with DDT to gain 
access to the program's symbol table. 

The entire text of the title is printed on each page of 
the program listing. 

Only one TITLE statement is allowed in a module; 
programs with PRGEND statements can use one TITLE 
statement for each module. 

A TITLE statement can appear anywhere in the program; 
it usually appears as the first line of the program. 

If no TITLE statement is used, the assembler inserts 
the program name ".MAIN". 

TITLE FLOATING-POINT NUMBER PACKAGE 

The program name is FLOATI; the words FLOATING-POINT 
NUMBER PACKAGE will appear at the head of each page and 
subpage of the listing. 

SUBTTL, UNIVERSAL 



Using more than one TITLE in a program. 

Using TITLE and UNIVERSAL in the same module (M error) . 
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PSEUDO-OPS 



TWOS EG 



FORMAT 



FUNCTION 



TWOSEG expression 

expression = any expression giving a nonnegative value 
as the beginning of the program high segment; 
cannot be EXTERNAL. 

Directs MACRO to assemble a two-segment program with 
the high segment beginning at the given address. MACRO 
sets the location counter to the given address, and 
generates a REL Block Type 3, which tells LINK to 
expect two segments. (The address is reduced to the 
next lower multiple of 2000 (octal) . If this result is 
0, the address defaults to 400000.) 

Only one TWOSEG pseudo-op is allowed in a program. 

High-segment code is controlled by using RELOC with a 
value at least as large as the TWOSEG address. 
Low-segment code is controlled by smaller RELOC values. 



NOTE 

Using TWOSEG without an argument sets the 
beginning address for the high segment to 
400000. However, this does not set the 
location counter to 400000. 



EXAMPLES 



TWOSEG 
RELOC 

data: block ioooo 

RELOC 400000 
start: EXIT 



?Low segment 
rH.ish segment 



RELATED 
PSEUDO-OPS 



LOC, .ORG, RELOC 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address argument. 

Using TWOSEG more than once in a program (Q error) . 

Generating relocatable code before the TWOSEG pseudo-op 
(Q error) . 

Using PSECT and TWOSEG in the same program. 
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PSEDDO-OPS 



UNIVERSAL 



FORMAT 
FUNCTION 



UNIVERSAL tablename 

Declares the symbol table of the current program 
available to other programs, and stores the given 
tablename in MACRO'S internal UNIVERSAL table. The 
tablename is also taken as the program name, and 
appears in the heading of each page of the listing 
file. 

When an END or PRGEND statement is found, the symbol 
table is placed immediately after the assembler's 
pushdown stacks and buffers. In addition to this 
memory-resident copy of the UNIVERSAL symbol table, the 
file tablename. UNV is generated. (This file can be 
suppressed by the /U switch described in Table 7-1.) 

UNIVERSAL files can be used to generate data, but are 
more commonly used to generate symbols, macros, and 
OPDEFs. The symbols and OPDEFs generated in a 
UNIVERSAL program need not be declared INTERNAL, since 
its local symbols are available to accessing programs. 
(See the SEARCH pseudo-op.) 

Memory-resident UNIVERSAL symbol tables are cleared on 
each run (.R MACRO) or START, but are not cleared when 
MACRO responds with an asterisk. This saves redundant 
lookups when many programs search a common set of 
UNIVERSALs. 

Note that if a sequence of programs (or even one 
program) searches more than ten UNIVERSAL symbol 
tables, a SEARCH table overflow occurs. This overflow 
forces reinitialization of the assembler by a run (.R 
MACRO) or START command. 

For a UNIVERSAL program that does not generate data 
(that is, it has only symbol, macro, and OPDEF 
definitions) , you can save time by using 1-pass 
assembly. However, such a file must not contain 
forward references to symbol definitions. 

A UNIVERSAL file cannot contain PSECTs. 

(Continued on next page) 



3-75 



PSEUDO-OPS 



UNIVERSAL (Cont. 



NOTES 



For COMPILE-class commands, the existence 
of the file tablename.REL may prevent 
recompilation of the UNIVERSAL file 
tablename .MAC . To avoid this, force 
compilation of the .MAC file by including 
/COMPIL in the command string. 

Generally, a UNIVERSAL file need not be 
reassembled when referencing programs are 
assembled with newer versions of MACRO. 
However, if the UNIVERSAL' s assembler 
version is newer than the program's, you 
may get the MCRUVS message, indicating 
skewed UNIVERSAL versions. In this case, 
reassembly or one or both files is required 
(using the same assembler version) . 



EXAMPLES 



UNIVERSAL. SI 
START=765 
AC1 = 1 

END 



RELATED 
PSEUDO-OPS 



SEARCH, TITLE 



COMMON 
ERRORS 



Using TITLE and UNIVERSAL in the same module (M error) 
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PSEUDO-OPS 



VAR 



FORMAT 
FUNCTION 



EXAMPLES 



VAR 

Causes variable symbols (defined in previous statements 
by suffixing the number sign (#) , or by ARRAY or 
INTEGER statements) to be assembled as BLOCK 
statements. This has no effect on subsequent 
definitions of symbols of the same type. 

If the VAR statement does not appear in the program, 
all variables are stored at the end of the program. 

If the pseudo-op TWOSEG is used, the variables reserved 
by an array statement must be assigned to the low 
segment; thus a RELOC back to the low segment is 
required before using the VAR pseudo-op. 



201 
202 



RELATED 
PSEUDO-OPS 



402003' 
402004' 
402005' 
402006' 
402007' 
402010' 
402011' 
001052' 
001052' 
001055' 



ARRAY, BLOCK, INTEGER 



01 01 000000 
01 00 402012' 

201 02 02 000000 

202 02 00 402013' 
140 01 00 000002 
200 01 00 402014' 
263 17 00 000000 



ADD2: MOVE I 1>0(1) 

MOVEM 1, FIRST* 
MOVEI 2>0(2> 
MOVEM 2, SECOND* 
ADD 1*2 
MOVE If SUM* 
POP J 17 r 
RELOC 
VAR 
BLOCK 2 
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PSEUDO-OPS 



XALL 



FORMAT 
FUNCTION 



XALL 

Resumes standard listing after previous LALL or SALL. 
(XALL is the default among these three.) 

XALL suppresses all lines of the program listing file 
that do not generate binary code. 

XALL does not suppress REPEAT expansions. 



NOTE 

Under XALL only one listing line is output for 
each source line generating binary code in a 
macro expansion. Occasionally, a single line 
of a macro definition expands into several 
lines of listing text. When this occurs, part 
of a binary-generating source line may not be 
listed . 

You can avoid this by temporarily setting the 
listing mode to LALL (list all) or SALL 
(suppress all) around such lines. 



RELATED 
PSEUDO-OPS 



LALL, LIST, SALL, XLIST 



OPTIONAL 
NOTATIONS 



Use the /X switch described in Table 7-1 
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PSEUDO-OPS 



.XCREF 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



•XCREF symbol ,... , symbol 

Suspends output of cross-referencing for the specified 
symbols. References to these symbols between this 
statement and the next .CREF or the end of the program 
will not appear in the cross-reference listing. 

.XCREF 

If no symbol names are specified, MACRO suspends 
cross-referencing for all symbols. 

.CREF 



Specifying a nonexistent symbol (A error) . 
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PSEUDO-OPS 



XLIST 



FORMAT 
FUNCTION 

EXAMPLES 



XLIST 

Suspends output to the program listing file. This 
output occurs only in Pass 2; XLIST does not affect 
Pass 1. To resume output, use the pseudo-op LIST. 

The following sequence of code shows an XLIST pseudo-op 
suppressing listing of literals: 

EXIT J End af program 

XLIST J Don't list literals 

LIT 

LIST 

END 



This sequence of code lists as: 

401023' 104 00 00 000170 HALTE J End of Pros! ram 

XLIST J Don't list literals 

LIST 

END 

Note that the high-segment break will be greater than 
401023' because the literals are assembled after the 
HALTF. 



RELATED 
PSEUDO-OPS 

OPTIONAL 
NOTATIONS 



LALL, LIST, SALL, XALL 



Use the /S switch described in Table 7-1. 
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PSEUDO-OPS 



XPUNGE 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



XPUNGE 

Deletes all local symbols during Pass 2. This reduces 
the size of the .REL file and speeds up loading. 
XPUNGE should immediately precede the END statement. 

PURGE 
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PSEUDO-OPS 



XWD 



FORMAT 
FUNCTION 



XWD lefthalf ,righthalf 

Enters two halfwords in a single storage word. Each 
half is formed in a 36-bit register, and the low-order 
18 bits are placed in the halfword. The high-order 
bits are ignored. 

XWD statements are used to set up pointer words for 
block transfer instructions. Block transfer pointer 
words contain two 18-bit addresses; the left half is 
the starting location of the block to be moved, and the 
right half is the first location of the destination. 



EXAMPLES 



402017' 200 02 00 403040' 
402020' 251 02 00 403035' 



402636' 
402736' 



FR0M1 

toi: 



40303! 



MOVE 2>CXWD FROMi»T01D 

BLT 2>T0END1 

♦ ♦ ♦ 

BLOCK 100 

BLOCK 100 

T0END1=.--1 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



lefthalf, ,righthalf 

BYTE (18)lefthalf ,righthalf 

Using halfword with absolute value larger than 18 bits 
(Q error) . 

Using two commas between the arguments to XWD. For 
example, XWD A, 3 is correct; XWD A,, 3 is incorrect. 
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FORMAT 
FUNCTION 

EXAMPLES 



Z accumulator, address 

Z is treated as if it were the null machine language 
mnemonic. An instruction word is formed with zeros in 
bits to 8. The rest of the word is formed from the 
accumulator and address. (See Section 4.7.1.) 



403036' 000 00 00 000000 
403037' 000 01 04 000002 



Z 1,2(4) 
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CHAPTER 4 
MACRO STATEMENTS AND STATEMENT PROCESSING 



A MACRO statement has one or more of the following: a label, an 
operator, one or more operands, and a comment. The general form of a 
MACRO statement is: 



label: operator operand , operand 
A carriage return ends the statement. 



; comment 



NOTES 



Direct-assignment statements receive 
special handling. (See Section 
2.4.2.2.) 

Processing of macros is not 
discussed here because a macro call 
produces a text substitution. After 
substitution, the text is processed 
as described in this chapter. 
Macros are discussed in Chapter 5. 



4 . 1 LABELS 

A label is always a symbol with a suffixed colon. (See Section 
2.4.2.1.) The assembler recognizes a label by finding the colon. If a 
statement has labels (you can use more than one) , they must be the 
first elements in the statement. 



A label can be defined only once; its value is 
first word of code generated after it. 



the address of the 



Since a label gives an address, the label can be either absolute or 
relocatable. A label is a local symbol by default. You can declare a 
label INTERNAL global or EXTERNAL global. (See Section 2.4.5.) 
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4 . 2 OPERATORS 

After processing any labels, the assembler views the following 
nonblank, nontab characters as a possible operator. An operator is 
one of the following: 

1. A MACRO-def ined mnemonic. All mnemonics are listed in 
Appendix C, and are discussed in the Hardware Reference 
Manual . 

2. A user-defined operator. (See the pseudo-op OPDEF in Chapter 
3.) 

3. A pseudo-op. (See Chapter 3.) 

If the characters found do not form one of the above, then MACRO views 
them as an expression. 

An operator is ended by the first non-RADIX50 character: if it is 
ended by a blank or tab, operands may follow; if it is ended by a 
semicolon, there are no operands and the comment field begins; if it 
is ended by a carriage return, the statement ends and there are no 
operands or comments. 



4 . 3 OPERANDS 

After processing labels and the operator, if any, the assembler views 
as operands all characters up to the first unquoted semicolon or 
carriage return. Commas delimit the operands. 

The operator in a statement determines the number (none, one, two or 
more) and kinds of permitted or required operands. Any expected 
operand not found is interpreted as null. An operand can be any 
expression or symbol appropriate for the operator. 



4 . 4 COMMENTS 

The first unquoted semicolon in a statement begins the comment field. 
You can use any ASCII characters in a comment; however, angle 
brackets in a comment may produce unpredictable results. You can 
continue a comment to the next line by typing CTRL/ , followed by a 
carriage return. 

If the first nonblank, nontab character in a line is a semicolon, the 
entire line is a comment. You can also enter a full line of comment 
with the pseudo-op REMARK, or a multiline comment with the pseudo-op 
COMMENT. (See Chapter 3.) 

Comments do not affect binary program output. 
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4.5 STATEMENT PROCESSING 

MACRO processes your program as a linear stream of data. During Pass 
1, MACRO may find references to symbols not yet defined. These 
symbols are entered in the user symbol table. Whenever a symbol is 
defined, it is entered in the table with its value, so that on Pass 2 
all definitions can be found in the table. The values then replace 
the symbols in the binary code generated. 

NOTE 

Delayed definition is allowed only for 
labels and direct-assignment symbols. A 
symbol that contributes to code 
generation (for example, an OPDEF, a 
macro, or a REPEAT index) must be 
defined before any reference to it. 

Statement processing proceeds as follows: 

1. Labels are found and entered in the user symbol table. 

2. The next characters up to the first unquoted semicolon, 
blank, tab, comma, or equal sign are processed. 

a. Equal sign: the characters form a symbol, and the 
following characters form an expression. The symbol and 
the value of the expression are entered in the user 
symbol table. 

b. Other delimiter: the characters form an expression or an 
operator. If an operator, it is found in a table and 
assembled. If an expression, its value is assembled. 

3. If the operator takes operands, the next characters up to the 
first unquoted semicolon or carriage return form operands. 
Unquoted commas delimit operands. For each operand, leading 
and trailing blanks and tabs are ignored. Operands are 
evaluated and assembled for the given operator. 

4. The first unquoted semicolon ends processing of the line. 
Any further characters up to the first carriage return are 
comment . 

5. The first unquoted carriage return ends the statement. Any 
following Characters begin a new statement. 



4.6 ASSIGNING ADDRESSES 

MACRO normally (and by default) assembles statements with relocatable 
addresses. Assembly begins with the zero storage word and proceeds 
sequentially. Each time MACRO assembles a word of binary code, it 
increments its location counter by 1. 
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A mnemonic operator generates one word of binary code. Direct- 
assignment statements and some pseudo-ops do not generate code. Some 
pseudo-ops generate more than one word of code. 

You can control address assignment by setting the assembler's location 
counter using the pseudo-ops LOC and RELOC. (See Section 9.1.) 

You can also reference addresses relative to the location counter by 
using the dot symbol (.). For example, the expression .-1 used as an 
address refers to the location immediately preceding the current 
location. 

In revising MACRO programs, you can cause an incorrect address to be 
assembled by adding or removing statements within the range of a .+n 
expression. For example, in the sequence 

000000' 332 00 01 000000 SKIPE 0<AC) 
000001' 254 00 00 001020' JRST GOTONE 
000002' 344 01 00 000000' AQJA AC?. -2 

the expression .-2 gives the address of the SKIPE statement. If you 
revise this sequence by inserting a statement, you should change the 
expression to .-3 so that it still refers to the correct statement. 



000000' 332 00 01 000000 SKIPE 0<AC) 

000001' 254 00 00 001020' JRST GOTONE 

000002' 350 00 00 000014 AGS NULCNT 

000003' 344 01 00 000000' AOJA ACr*~3 



$ Added line 
? Changed line 



For this reason, use great care with such expressions other 
and .-1. Using labels avoids this problem entirely. 



than .+1 



4.7 MACHINE INSTRUCTION MNEMONICS AND FORMATS 

There are two kinds of machine instruction mnemonics: primary and 
input/output. Primary instructions generate binary code in primary 
instruction format; input/output instructions generate binary code in 
input/output instruction format. 



4.7.1 Primary Instructions 

A primary instruction is in one of the forms 

mnemonic accumulator , address 
mnemonic accumulator, 
mnemonic address 

where mnemonic is a machine instruction mnemonic, accumulator is an 
accumulator register address, and address is a memory address. The 
memory address can be modified by indexing, indirect addressing, or 
both . 
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A complete list of machine instruction mnemonics and their octal codes 
is given in Appendix C, and these mnemonics are discussed in the 
Hardware Reference Manual . 

The accumulator address gives the address of a register, and can be 
any expression or symbol whose value is an integer in the range to 
17 octal. 

The memory address gives a location in memory, and can be any 
expression or symbol whose value is an integer in the range to octal 
777777. 

You can modify the memory address by indirect addressing, indexed 
addressing, or both. For indirect addressing, prefix an at sign (@) 
to the memory address in your program. For indexed addressing, suffix 
an index register address in parentheses to the memory address in your 
program. This address can be any expression or symbol whose value is 
an integer in the range 1 to octal 17. 

NOTE 

To assemble the index, MACRO places the 
index register address in a fullword of 
storage, swaps its halfwords, and then 
adds the swapped word to the instruction 
word . 

For an example of a primary instruction (assuming that AC17, TEMP, and 
XR have the octal values 17, 100, and 3, respectively), the statement 

ADD AC17»©TEMP<XR) 

generates the binary code 

instruction indirect memory 

code . bit address 

010 111 000 1 111 1 011 000 000 000 001 000 000 

accumulator index 
register 

which appears in the program listing as 

270 17 1 03 000100 ADD AC17r 6TEMP< XR) 

The mnemonic ADD has the octal code 270, and this is assembled into 
bits to 8. The accumulator goes into bits 9 to 12. Since the @ 
appears with the memory address, bit 13 is set to 1. The index 
register goes into bits 14 to 17. Finally, the memory address is 
assembled into bits 18 to 35. 

If any element is missing from a primary instruction, zeros are 
assembled in its instruction word field. 
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A. 1.2 Mnemonics With Implicit Accumulators 

A few mnemonics set bits in the accumulator field as well as in the 
instruction field. Therefore these mnemonics do not take accumulator 
operands, and are of the form 

mnemonic address 

These mnemonics and their octal codes are listed in Table C-5 in 
Appendix C. 

For example, the mnemonic JFOV gives the octal code 25504; JFCL gives 
255. Therefore both give the opcode 255 in bits to 8, but JFOV also 
sets the accumulator bits (9 to 12) to binary 0001. This makes JFOV 
100 equivalent to JFCL 1,100: 

255 01 00 000100 JFOV 100 
255 01 00 000100 JFCL 1>100 



4.7.3 Input/Output Instructions 

An input/output statement in your program resembles a primary 
instruction statement except that the first operand gives a device 
number instead of an accumulator. The general format is: 

mnemonic device ,address 

In an input/output instruction, the indirect, index, and address 
fields (bits 13 to 35 inclusive) are assembled exactly as in a primary 
instruction. 

Unlike a primary instruction word, however, an input/output word has a 
split instruction code in bits to 2 (always set to 111 binary) and 
10 to 12, and a device code in bits 3 to 9. The device code can be 
any expression or symbol giving a valid device code for your system. 

(MACRO-def ined I/O instruction mnemonics and device code mnemonics are 
listed in Tables C-2 and C-3 in Appendix C.) 

For example (assuming that NVR has the octal value 1037) , the 
statement 

DATAI CDR,@NVR(4) 

generates the binary code 

device indirect memory 

code bit address 

111 001 001 1 00 1 1 100 000 000 001 000 Oil 111 

instruction index 

code register 

which appears in the listing as 

7 114 04 1 04 001037' DATAI CDR>0NVR(4) 
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The octal code for the mnemonic DATAI is 70004, which is written in 
bits to 14. The octal device code 114 (for card reader) is then 
overwritten in bits 3 to 9. The @ in the statement sets bit 13 to 1. 
The index register and memory address are placed in bits 14 to 17 and 
18 to 35, as in a primary instruction. 



4.7.4 Extended Instructions 

The KL10 Extended Instruction Set is a multifunction instruction set 
that performs character-string editing, decimal-to-binary conversion, 
string move with left or right justification, string move with offset 
or translation, and string compare. 

The Extended Instruction Set consists of a single KL10 instruction 
(EXTEND, octal 123) and a set of 16 extended operators. (See the 
Supplement to the Hardware Reference Manual .) 

The KL10 EXTEND instruction mnemonics are listed in Table C-4 in 
Appendix C. 
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CHAPTER 5 
USING MACROS 



A macro is a sequence of statements defined and named in your program. 
When you call a macro (by invoking its name in your program) , the 
sequence of statements from its definition is generated in line, 
replacing the call. A macro can have arguments. 

By using macros with arguments, you can generate passages of code that 
are similar, but whose differences are controlled by the passed 
arguments. This saves repetition in building a source file. 



5.1 DEFINING MACROS 

Before you can call a macro, you must define it. You can also 
redefine a macro if you wish; the new definition simply replaces the 
old one. 

To define (or redefine) a macro, use the pseudo-op DEFINE: 

DEFINE macroname (darglist) <macrobody> 

where macroname is the name of the macro, darglist is an optional list 
of dummy-arguments, and macrobody is a sequence of statements. 

The macroname is a symbol; you must follow the rules for valid 
symbols in selecting a macroname. (See Section 2.4.1.) 

The optional dummy-argument list can give one or more dummy-argument 
symbols through which values are passed to the sequence of statements. 
If a macro definition has dummy-arguments, they must be enclosed in 
parentheses. Use commas as delimiters between dummy-arguments. For 
each dummy-argument, leading and trailing spaces and tabs are ignored. 

The macrobody is the sequence of statements you want to generate when 
you call the macro. The macrobody must be enclosed in angle brackets. 

Here is an example of a macro definition: 
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DEFINE VMAG ( WHERE >LENG> < 

i Vector length routine 



MOVE Of WHERE » 


Get first 




component 


FMP i 


Sauare it 


MOVE lrWHERE+1 i 


Get second 




component 


FMP It I i 


Sauare it 


FAD 1 > 


Add sauare 




of second 


MOVE 1> WHERE f 2 i 


Get third 




' component 


FMP tfl 


» Sauare it 


FAD 1 


(Add sauare 




i of third 


PUSH J 17»FSQRT 


J Floating SORT 




) routine 


MOVEM LENG 


t Store the 




t length 



NOTE 

Comments in a macro use storage. If you 
begin a comment with a double semicolon, 
the comment is listed in the definition 
but not stored for listing with 
expansions . 



5.2 CALLING MACROS 

You can call a macro by putting its name in your program. Recall that 
you must define the macro before you can call it. You can use the 
macroname as a label, an operator, or an operand. 

If the macro's definition has dummy-arguments, the macro call can have 
arguments. The arguments passed to the macro are inserted into the 
defined sequence of statements as it is generated. The first passed 
argument replaces the first dummy-argument; the second passed 
argument replaces the second dummy-argument; this treatment continues 
for each argument passed. Any missing arguments are passed as nulls 
(zeros) or filled in by default arguments (see Section 5.5). 



NOTE 



If F00 is a macro w 
arguments, the call 
and C as the first and 
The second argument is 
it is not considered mi 
be replaced by a defau 
fourth argument is miss 
replaced by a defaul 
has been defined; o 
passed as nulls. (See 



ith four dummy- 
FOO A, ,C passes A 
third arguments, 
passed as nulls; 
ssing and cannot 
It argument. The 
ing and will be 
t argument if one 
therwise it is 
Section 5.5.1.) 
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After argument substitution, the defined sequence of statements 
replaces the macroname and argument list in the source text. For 
example, suppose you have defined VMAG(A,B) as shown in Section 5.1 
above, and VMAG appears in your program as 





LALL 








P7=245 








VLEN=11 








PLACE=15 






tagi: 


MOVE 1>P7 


JGet 


P7 




MOVEM PLACE 


J Put 


it in 1 


TAG2: 


VMAG PLACE ,VLEN 






TAG3J 


MOVE 1>VLEN 


J Get 


length 



PLACE 



Then the code to be assembled is: 



000245 
000011 
000015 
200 01 00 000245 
202 00 00 000015 



200 


00 





00 


000015 


160 
200 


00 
01 






00 
00 


000000 
000016 


160 
140 


01 
00 






00 
00 


000001 
000001 


200 


01 





00 


000017 


160 
140 


01 
00 






00 
00 


000001 
000001 


264 


00 





00 


001007' 


202 


00 





00 


000011 





LALL 






P7-245 






VLEN=11 






PLACE=15 




tagi: 


MOVE lrP7 


J Get P7 




MOVEM PLACE 


iPut it in PLACE 


TAG2: 


VMAG PLACE >VLEN 


n 




JVector length 


routine 




MOVE 0>PLACE 


»Get first 
i component 




FMP 


rSauare it 




MOVE l,PLACEfl 


J Get second 
f component 




FMP 1>1 


JSwuare it 




FAD 1 


JAdd sauare 
f of second 




MOVE lrPLACE+2 


JGet third 
i component 




FMP 1»1 


$ Sauare it 




FAD 1 


J Add sauare 
r of third 




JSR FSQRT 


^Floating SORT 
? routine 




MOVEM VLEN 


? Store 
r length 



200 01 00 000011 



TAG3! 



MOVE 1»VLEN 



J Get length 



Notice that the macro definition has the dummy-arguments A and B in 
the macrobody. The call VMAG PLACE, VLEN causes PLACE to replace each 
appearance of A, and VLEN to replace each appearance of B. 



NOTES 



Under LALL, when the text of a 
macrobody is listed at call, it is 
enclosed in up-arrows ("). 

Under XALL, the beginning of the 
text of a macrobody is marked by an 
up-arrow; the ending is marked by 
an up-arrow only if the last line of 
the macrobody generates binary code. 
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5.2.1 Macro Call Format 

In a macro call, delimit the macroname with one or more blanks or 

tabs . 

If the macro has arguments, the first nonblank, nontab character 
begins the argument list. Each argument ends with a comma, a carriage 
return, or a semicolon. These three characters cannot be used within 
arguments unless enclosed by special quoting characters. (See Section 
5.2.2.) 

Leading and trailing spaces and tabs are stripped from each argument 
unless they are within special quoting characters. Embedded spaces 
and tabs are not stripped. 

You can continue an argument to the next line by using 
CTRL/underscore . Otherwise an unquoted carriage return or semicolon 
ends the argument and the argument list. An unquoted semicolon also 
begins the comment field. 



5.2.2 Quoting Characters in Arguments 

The special quoting characters for macro argument handling are: 

< > angle brackets 

( ) parentheses 

[ ] square brackets 

" " quote marks 

NOTE 

Single quote marks (apostrophes) are not 
special quoting characters. 

Any character, including the semicolon ( ; ) , enclosed in special 
quoting characters is treated as a regular character. If one of the 
special quoting characters is to be passed as a regular character, it 
must be enclosed by different special quoting characters. 

Here are the rules for macro argument handling. In the examples, F00 
is assumed to be a defined macro: 

1. The special quoting characters are not argument delimiters. 
They only tell the assembler to treat the enclosed characters 
as regular characters. 

F00 C<A,B> has one argument: C<A,B>. 

F00 C,D<A,B> has two arguments: C and D<A,B>. 
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2. With the two exceptions explained below, special quoting 
characters are always included in passed arguments. 

FOO A,(B,C) has two arguments: A and (B,C). 

FOO [XWD 1,L1]-1(AC) has one argument: [XWD 1,L1] -1 (AC) . 

FOO " ( " , has two arguments": " ( " and 0. 

Exception 1: If the first character of the argument list is 
a left parenthesis, then it and its matching right 
parenthesis delimit the argument list. They are not treated 
as special quoting characters and are not included in passed 
arguments. All nested quoting characters except angle 
brackets are disabled. After stripping the outer 
parentheses, angle brackets are handled as described in 
Exception 2 below. 

FOO (A,B,C) has three arguments: A, B, and C. 

FOO (7LENGTH >132) has one argument: 7LENGTH >132. 

FOO ([A,B]) has two arguments: [A and B] . 

FOO (<A,B>) has one argument: A,B. 

Exception 2: If a left angle bracket is the first character 
of the argument list, or the first character after an 
unquoted comma, then it and its matching right angle bracket 
are treated as special quoting characters, but are not 
included in passed arguments. 

FOO <A,B>,C has two arguments: A,B and C. 

FOO C,<A,B> has two arguments: C and A,B. 

You can alter this argument handling by using the pseudo-op .DIRECTIVE 
with MACMPD, .ITABM, and .XTABM. (See Chapter 3.) 

NOTE 

To pass special characters in a macro 
call, we suggest defining the macro so 
that the delimiters are part of the 
passed argument. For example, use 

DEFINE Tl (A) <0UTSTR TASCIZ A3> 

rather than 

DEFINE T2 (A) <0UTGTR CASCIZ \AV.1> 

The call Tl ">>" will work, but T2 ">>" 
will not. 
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5.2.3 Listing of Called Macros 

You can control the listing of called macros by using the pseudo-ops 
XALL, SALL, and LALL. LALL causes macro expansions to be listed in 
full; XALL suppresses part of the listing; LALL suppresses all of 
the listing. The default among these three is XALL. 



The following example shows the action of these pseudo-ops on 
listings : 



macro 







DEFINE 


F00 (NX 






IFE Nr 


:'2> 






IFN N, 


:."1> 






SALL 




000000 


000002 


F00<0) 




000000 


000001 


FOOd) 

XALL 

F00(0) 




000000 


000002 


IFE Or 
FOOd) 


:' *? > 


000000 


000001 


IFN lr 
LALL 


:.1> 






FOO(O) 




000000 


000002 


IFE Or 


:;• n ••;. 






IFN 0» 


a> 






FOOd) 








IFE 1> 


::"?'> 


000000 


000001 


IFN lr 


<1> 



5.3 NESTING MACRO DEFINITIONS 

You can nest macro definitions. That is, you can define a macro 
within the body of another macro definition. Notice, however, that 
the nested macro is not defined to the assembler until the nesting 
macro is called. 

Here is an example: 

DEFINE PERSON (A) < 

DEFINE CHILD (B) < 

DEFINE GRANDCHILD <C> < 
EXP AfByO 
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Until the DEFINE PERSON statement is assembled, calls to PERSON, 
CHILD, and GRANDCHILD are illegal. These macros are not yet defined 
to the assembler. 

When the DEFINE PERSON statement is reached and assembled, PERSON can 
be called, but not CHILD or GRANDCHILD. The call PERSON 1 generates 
the text 

PERSON 1" 

DEFINE CHILD (B) < 

DEFINE GRANDCHILD (C) < 
EXP lfBrO 



thus defining CHILD to the assembler, 
generates the text 



The following call CHILD 2 



CHILD 2' 



DEFINE GRANDCHILD (C) 
EXP 1,2>C> 



and GRANDCHILD is defined to the assembler. Finally, a call to 
GRANDCHILD 3 generates 



000000 000001 
000000 000002 
000000 000003 



GRANDCHILD 3' 



EXP 1>2,3' 



Notice the result of a subsequent call to CHILD 10. The text 

CHILD 10~ 

DEFINE GRANDCHILD (C) < 
EXP 1*10*0 



is generated, and this definition replaces the old definition of 
GRANDCHILD; the definitions of PERSON and CHILD are not changed. 
After this, the call GRANDCHILD 3 generates 



000000 000001 
000000 000010 
000000 000003 



GRANDCHILD 3' 



EXP lrlO/3' 



NOTE 

Using multiple angle brackets for a 
passed argument preserves the argument 
as one unit. For example passing the 
argument <<A,B,C>> to nested macros 
causes the outer macro to pass <A,B,C> 
as one argument; the first nested macro 
passes A, B, and C as three arguments. 
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5.4 CONCATENATING ARGUMENTS 

The apostrophe (') is the concatenation operator for macro calls. If 
you insert an apostrophe immediately before or after a dummy-argument 
in the body of a macro, the assembler removes it at call. This 
removal joins (concatenates) the passed argument to the neighboring 
character in the generated text. 

(One application of this concatenation is shown under COMMON ERRORS 
for the ASCIZ pseudo-op.) 

If the apostrophe precedes the dummy-argument, the passed argument is 
suffixed to the preceding character; if the apostrophe follows the 
dummy-argument, the passed argument is prefixed to the following 
character . 

You can use more than one apostrophe with a dummy-argument. In this 
case only apostrophes next to the dummy-argument will be removed (at 
most one from each side) . Other apostrophes are treated as regular 
characters in the macrobody. The following example shows the 
treatment of apostrophes on both sides of the dummy-argument, and of 
double apostrophes. 

DEFINE ( PREFIX rMIDFIX) < 

DEFINE OCOMP (SUFFIX) < 

PREFIX 'O'MIDFIX' 'SUFFIX> 



Now the call A, J generates 

DEFINE OCOMP (SUFFIX) < 
AOJ'SUFFIX> 

because when the assembler replaces PREFIX with A, the apostrophe 

following is removed to form AO. When J replaces MIDFIX, the 

preceding apostrophe and first following apostrophe are removed to 
form AOJ'SUFFIX. 

Now the call OCOMP LE generates 

OCOMP LE" 
343 00 00 000000 AOJLE" 

since the apostrophe is removed to join AOJ to LE. 



5.5 DEFAULT ARGUMENTS AND CREATED SYMBOLS 

Ordinarily, an argument missing from a macro call is passed as nulls. 
For example, the macro defined by 

DEFINE WORDS (A»B,C) < 
EXP AfBfD 

when called by WORDS 1,1 generates three words containing 1, 1, and 0, 
respectively. 

WORDS lfl" 
000000 000001 EXP Mr" 

000000 000001 
000000 000000 
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You can, however, alter this handling by specifying default 
other than nulls, or by using created symbols. 



values 



5.5.1 Specifying Default Values 

If you want a missing argument to default to some value other than 
nulls, you can specify the default value in your DEFINE statement. Do 
this by inserting the default value in angle brackets immediately 
after the dummy-argument. For example, the macro defined by 

DEFINE WORDS ( ArB<222>>C<333>)< 
EXP A*B>C> 



when called by WORDS 1,1 generates three words containing 1, 
333, respectively. 



000000 000001 
000000 000001 
000000 000333 



WORDS lrl~ 

EXP It If 333' 



1 , and 



NOTE 

An argument passed as nulls by 
consecutive commas is not considered 
missing and cannot invoke a default 
value. Therefore missing arguments can 
occur only at the end of the list of 
passed arguments. 



5.5.2 Created Symbols 

A symbol used as a label in a macrobody must be different for each 
call of the macro (since duplicate labels are not allowed) . Therefore 
for each call a different symbol for the label must be passed as an 
argument. 

If you do not refer to such a label from outside the macro, you can 
simply let the assembler provide a new label for each call. This 
label is called a created symbol, and is of the form ..nnnn where nnnn 
is a 4-digit number. 

To use a created symbol in place of a passed argument, use the percent 
sign (%) as the first character of the dummy-argument in your DEFINE 
statement. The assembler then creates a symbol for use in the macro 
expansion if that argument is missing from a call to the macro. If 
you provide an argument in the call, the passed argument overrides the 
created symbol. 
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NOTES 



1. A null argument (indicated by two 
adjacent delimiters) is not treated 
as missing. 

2. Avoid using symbols of the form 
. .nnnn, since they could interfere 
with created symbols. 



The following example shows a macro defined with a created symbol, the 
macro called using the created symbol, and the macro called overriding 
the created symbol: 

DEFINE COMPAR ( TEST ? SAVE » INDEX >%HERE) < 

zhere: move save f test 

SETZ INDEX f 

CAME SAVE r TABLE (INDEX) 

JRST XHERE 

COMPAR TlrT2rT3" 

. ,0001: MOVE T2»T1 

SETZ T3» 

CAME T2 f TABLE (T3) 

JRST ♦♦0001 
COMPAR TlrT2rT4rHEREl~ 
HEREi: MOVE T2»T1 

SETZ T4 

CAME T2 t TABLE (T4) 

JRST HEREI 



5.6 INDEFINITE REPETITION 

The pseudo-ops IRP, IRPC, and STOPI give a convenient way to repeat 
all or part of a macro; you can change arguments on each repetition 
if you wish, and the number of repetitions can be computed at assembly 
time. You can use these three pseudo-ops only within the body of a 
macro definition. 

To see how IRP works, assume the macro definition 

DEFINE DOEACH (A) < 
IRP A><A>> 

The call DOEACH <ALPHA,BETA,GAMMA> produces the code 

000200 ALPHA=200 

000300 BETA=300 

000400 GAMMA-^400 

DOEACH <ALPHArBETAr GAMMA>" 
IRP 
000000 000200 ALPHA 

000000 000300 BETA 

000000 000400 GAMMA 



because each subargument passed to IRP generates one repetition of the 
code. Notice that the range of IRP must be enclosed in angle 
brackets . 
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NOTE 



Using angle brackets in the call to 
DOEACH is critical, since they make the 
string ALPHA, BETA, GAMMA a single 
argument for IRP. IRP then sees the 
commas as delimiting subarguments . 



IRPC is similar to IRP, but an argument passed to IRPC generates one 
repetition for each character of the argument. 

STOPI ends the action of IRP or IRPC after assembly of the current 
expansion. You can use STOPI with a conditional assembly to calculate 
a stopping point during assembly. For example: 

? Enter value of 111 for each radix from 2 to K 

DEFINE CON VI (L) < 

RADIX L J Set radix 

111 r Evaluate and enter 

RADIX S ?Back to radix 8 



DEFINE CONVERT (A) < 

IRP A,<IFE K-A»<STOPI> ? Still OK? 
C0NV1 A> rCONVl 



000004 



000000 000007 



000000 000015 



000000 000025 



K>4 

CONVERT <2»3>4»5 

IRP 
IFE K~-2»<ST0PI> 

RADIX 2 
111 
RADIX 8 

IFE K-3r<ST0PI> 



RADIX 3 
111 
RADIX 8 

IFE K-4,<ST0FI> 

RADIX 4 
111 
RADIX 8 



6>7t3r9>" 

Still OK? 
C0NV1 2" 
Set radix 

Evaluate and enter 
Back to radix 8 

Still OK? 
C0NV1 3" 
Set radix 

Evaluate and enter 
Back to radix 8 

Still OK? 
C0NV1 4" 
Set radix 

Evaluate and enter 
Back to radix 8 



9 CON VI 



5.7 ALTERNATE INTERPRETATIONS OF CHARACTERS PASSED TO MACROS 

The normal argument passed by a macro call is simply the string of 
characters given with the call. MACRO offers three alternate 
interpretations of the passed argument. 
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If you prefix a backslash (\) to an expression argument, the argument 
passed is the ASCII numeric character string giving the value of the 
expression . 

If you prefix a backslash-apostrophe (V) to an expression argument, 
the argument passed is the string whose value is the SIXBIT string 
with the integer value of the expression. 

If you prefix a backslash-quotemar k (\") to an expression argument, 
the argument passed is the string whose value is the ASCII string with 
the integer value of the expression. 

To show how these work, the following example defines a macro to print 
the argument passed. Then four different arguments are passed using 
the various argument interpretations. 

LALL 

DEFINE LOOK IE (ARG) < 

REMARK The passed argument is* ARG 

LOOKIE 60" 

REMARK The passed argument is* 60 

LOOKIE \60" 

REMARK The passed argument is* 60 ~ 

LOOKIE V60" 

REMARK The passed argument is? P 

LOOKIE \"60" 

REMARK The passed argument is! 

000060 Z=60 

LOOKIE Z~ 

REMARK The passed argument is* Z 

LOOKIE \Z" 

REMARK The passed argument is I 60 

LOOKIE VZ" 

REMARK The passed argument is* P 

LOOKIE \'Z" 

REMARK The passed argument is* 

635170 425164 ZZ='S.IXBIT' 

LOOKIE ZZ" 

REMARK The passed argument is* ZZ 

LOOKIE \ZZ" 

REMARK The passed argument is J 635170425164 " 

LOOKIE \'ZZ~ 

REMARK The passed argument ist SIXBIT 
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203234 162311 ZZZ- "ASCII 



LOOK. IE ZZZ" % 

REMARK The passed argument is J ZZZ 

LOOK.IE \ZZZ~ 

REMARK The passed argument is! 20323416231.1. 

LOOKIE \*ZZZ" 

REMARK The passed argument is! ASCII 
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CHAPTER 6 
ASSEMBLER OUTPUT 

MACRO can generate three kinds of output files: 

1. A program listing (.LST) file 

2. A binary program (.REL) file 

3. A UNIVERSAL ( . UNV) file 

6.1 THE PROGRAM LISTING FILE 

MACRO outputs the program listing file to the device you specify, 
usually your terminal or a disk file. You can control the form of the 
program listing by using the pseudo-ops .DIRECTIVE FLBLST, .DIRECTIVE 
SFCOND, LIST, XLIST, LALL, XALL and SALL. (See Chapter 3.) All MACRO 
programs begin with the implicit pseudo-ops LIST and XALL. 

The listing has a heading at the top of each page and subpage. The 
first line gives the program name, the assembler version, the time and 
date of assembly, and the page number. The second line gives the 
program filename (including extension), the date and time of creation, 
and an optional program subtitle*. 

Example : 

TIMER MACRO %53(711) 10t07 27--APR-77 PAGE: 2 
TIMER MAC 27 -AUG- 77 10:06 MACDEP 

The listing has up to 55 lines per page. You can change this by using 
the L switch; /nnL specifies nn lines per page. A formfeed (CTRL/L) 
in your program begins a new page and increments the page number. If 
the linecount exceeds lines-per-page before a formfeed is found, a 
subpage number is formed. For example, the subpages following page 6 
are 6-1, 6-2, and so forth. A formfeed would begin page 7. 
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The five columns in the program listing give: 

1. The CREF line number (if the program was assembled with the 
CREF switch on) . 

2. The line sequence number (if the input file is sequenced). 

3. The 6-digit octal address of the storage word, usually a 
sequential location assignment. 

400066' 
400067' 
400070' 

An apostrophe (') after the address shows that it is 
relocatable. 

For a PHASE pseudo-op, the phased address is given. 

For a BLOCK pseudo-op, only the address of the first word is 
given. 

For a program with PSECTS, the 2-digit PSECT number of the 
current PSECT immediately follows the address. For example, 

000100'02 

For a LOC or RELOC pseudo-op, only the address to which the 
location counter is set is given; the next word of code will 
be assembled at that address. 

4. The assembled binary code (if any) in one of eight formats. 

Fullword: all zeros with number sign (000000000000#) , 
showing that a fullword Polish fixup is required 
for the word of code. 

Halfword: two 18-bit bytes. Each halfword can be 
followed by an apostrophe (') to indicate that it 
is relocatable, or by a pound sign (#) to indicate 
that a Polish fixup is required for it. When you 
use the .HWFRMT pseudo-op, all code is listed in 
halfword format. 

Instruction: 9-bit op-code; 4-bit accumulator code; 
1-bit indirect code; 4-bit index; 18-bit address. 

Input/output: 3-bit I/O code; 7-bit device code; 
3-bit operand; 1-bit indirect code; 4-bit index; 
18-bit address. 

Byte pointer: 6-bit byte position; 6-bit byte size; 1 
unused bit; 1-bit indirect code; 4-bit index; 
18-bit address. 

ASCII: five 7-bit bytes; one unused bit. 

SIXBIT: six 6-bit bytes. 
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BYTE: binary representation of specified bytes. Bytes 
appear on the program listing only to the extent 
that available horizontal space permits. For 
example, 36 1-bit bytes cannot be represented as 
individual bytes on the listing. Any halfword byte 
containing an address can be flagged by an 
apostrophe (') or by a pound sign (#) . See the 
halfword format above. 

OPDEF or assignment: one or two 18-bit bytes, as 
needed . 

These examples show some code in each format: 

000056' 000000000000* B=A+C 



000057' 000001 000017' 

000060' 000017 00000.1. 

000061' 255 01 00 000100 

000062' 255 01 00 000.100 

000063' 7 114 04 1 04 001037' 

000064' 7 110 20 1 05 000004 

000065' 21 06 00 000067' 

000066' 44 10 00 000070' 

000067' 07 00 01 000000 

000070' 006 004 002 000 00 

017000 000000 
026000 000000 

000071' 061 062 063 064 065 

000072' 101 102 103 104 105 

000073' 21 22 23 24 25 26 

000074' 41 42 43 44 45 46 



lyrTAGl 
AC17»»1 

JFOV 100 
JFCL IV 100 

DATA I CDR>GNVR<4 
CONO CDP»04<5) 



Pit 


POINT 6 f Bit 18 


P2: 


POINT 8rB2 


Bi: 


BYTE (6)7 r 0,1 


B2: 


BYTE <B)6fAf2f 




OPDEF Z1C17B83 




OPDEF Z2C26B8.1 



ASCII /: 12345/ 
ASCII \ABCDE\ 

SIXBIT /123456/ 
S.TXBIT \ABCDEF\ 



Halfword 
Halfword 

Instruction 
Instruction 

I/O 

E<yte pointer 
Byte pointer 

Bute 
Byte 

OPDEF 
OPDEF 

ASCII 
ASCII 

SIXBIT 
SIXBIT 



An apostrophe (') shows the code as relocatable. The 
examples show relocatable values in the right half of some 
words. The left half can also be relocatable. 

An asterisk (*) shows a symbol to be EXTERNAL or undefined. 

A number sign (#) shows that a Polish expression is required 
to resolve the value. 

5. Source statements and comments. 

If the assembler finds errors in a line of text, it suffixes one or 
more letters to the sequence number as error codes. These error codes 
are discussed in Chapter 8. A code is not repeated for multiple 
errors of the same type in a line. 
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At the end of the listing, the assembler gives the total number of 
errors, followed by break addresses. The program break is the largest 
relocatable address assembled, plus 1. The absolute break is the 
largest absolute address assembled. The high-segment break is the 
largest high-segment address assembled. For a program with PSECTs, 
the break for each PSECT is also given. 

The listing gives CPU time in the form mmrss.sss where mm is minutes 
and ss.sss is seconds. Core used is given in K's; one K is 1024 
words (2000 octal) . 

In the symbol table at the end of the listing, some symbols may have 
the following codes: 

ent result of ENTRY pseudo-op 

ext EXTERNAL symbol 

int INTERNAL symbol 

pol defined in terms of EXTERNAL symbols 

sen suppressed result of ENTRY pseudo-op 

sex suppressed EXTERNAL symbol 

sin suppressed INTERNAL symbol 

spd suppressed for debugger 

udf undefined symbol 

If you use the /C switch with MACRO, you can generate three additional 
tables in the program listing. The /C switch directs MACRO to 
generate the listing file in a format suitable for input to CREF, the 
cross-referencing program. This is a .CRF file rather than the usual 
.LST file. 

After assembly, the .CRF file can be used as input to CREF, and the 
output is the cross-referenced .LST file. This file contains the 
program listing and symbol table as described above. In addition, it 
has a cross-referenced symbol table, a table of macros and OPDEFs, 
and, if you use the /O switch with CREF, a cross-referenced table of 
opcodes and pseudo-ops. 

The cross-referenced symbol table lists each user-defined symbol 
(except macros, OPDEFs, and SYN symbols), and lists the sequence 
number of each line containing the symbol. 

The table of macros and OPDEFs shows each reference to macros, OPDEFs, 
and SYN symbols. 

The opcode table shows each reference to MACRO-def ined opcodes and 
pseudo-ops, giving the sequence number of each line containing the 
opcode or pseudo-op. 
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6.2 THE BINARY PROGRAM FILE 

MACRO outputs the binary program file to the device you specify, 
usually a storage device. The default device is a disk. Most of the 
file is the binary expansion of your program instructions. These 
instructions are formatted into groups called REL Blocks; each block 
is labeled so that LINK can recognize it. Details of this formatting 
and labeling are discussed in the LINK Reference Manual . 

A relocatable binary program file can be stored on any input/output 
device. The output format is not related to either block types or 
logical divisions of the device. 



6.3 THE UNIVERSAL FILE 

THE UNIVERSAL file is output only if the source file contains the 
UNIVERSAL pseudo-op. (See the discussions at UNIVERSAL in Chapter 3 
and in Section 9.2.) 

A UNIVERSAL file contains only symbols and definitions. These 
definitions are available to any program, and can be obtained by using 
the SEARCH pseudo-op. 
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To assemble a MACRO program, use one of the following: 

1. The operating system command COMPILE. (See the Monitor Calls 
manual for details.) 

2. The $MACRO card for the BATCH program. (See the GALAXY Batch 
Reference Manual . ) 

3. The MACRO command level. 

To assemble a program in the command level of MACRO, type R MACRO to 
the system. The system then runs MACRO, which responds with an 
asterisk (*) : 

♦R MACRO 
* 

Then define files for MACRO by typing a command of the form 

relfile,listfile=sourcefile, . . . ,sourcefile 
where : 

relfile is a filespec for the binary program output file. 

listfile is a filespec for the program listing output file. 

each sourcefile is a filespec for a source program input file; 
MACRO assembles source files in the order given. 

The default device for each file is DSK : , but you can override this by 
prefixing devicecode: to any of the files. Default file extensions 
are .REL for relfile, . LST for listfile (.CRF if you use the /C 
switch), and .MAC for each sourcefile. You can override these by 
suffixing a file extension to any of the files. 

You can specify a directory for any of these files by suffixing a 
project-programmer number (PPN) in square brackets. 

You can set switches by suffixing /char or (char) to a file, where 
char is a switch code. Switch codes and their meanings are given in 
Table 7-1. 



a 
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You can suppress the binary file by omitting its file specification 
(but keeping the comma) : 

,listfile=sourcefile,. . . , sourcefile 

You can suppress the listing file by omitting its file specification 
and the comma: 

relfile=sourcefile,. . . , sourcefile 

You can suppress both output files by omitting their file 
specifications (but keeping the equal sign): 

=sourcefile, . . . , sourcefile 

You can access an indirect file (containing valid asterisk-level MACRO 
command strings) by typing a command of the form: 

@ indirect file 

where indirectfile is the file specification for the file. 

Examples: 



DATE,DATE=DATE 

DATE=DATE 
,DATE=DATE 
= DATE 

DATE,TTY:=DATE 
DATE,DATE=TTY: 
DATE , DATE=TTY : , DSK : DATE 



Assemble source file DATE. MAC from disk 
into binary program file DATE.REL on 
disk, and put the listing in file 
DATE.LST on disk. 

No listing file. 

No binary file. 

No binary or listing file. Print all 
error diagnostics on the terminal. 

Send the listing to the terminal. 

Accept source code from the terminal. 

Accept source code from the terminal 
(usually symbol definitions) , followed 
by more source code from the disk. 
Notice that DSK must be specified; 
otherwise, TTY would be assumed. 



NOTE 

Many programmers use the following 
commands to check assembly of short code 
sequences : 

*>tty:-=tty: 

PASS2 

This displays the assembled code line by 
line as you type it in. 
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Table 7-1 
MACRO Switch Options 



Switch Meaning 



/A Advance magnetic tape reel by one file. The /A 
switch must immediately follow the device to which 
the switch refers. 

/B Backspace magnetic tape reel by one file. The /B 
switch must immediately follow the device to which 
the switch refers. 

/C Produce listing file in a format acceptable as input 
to CREF. Unless the filename is given, CREF.CRF is 
assumed; if no file extension is given, .CRF is 
assumed; if no listing device is specified, DSK: is 
assumed . 

The /C switch can be used only with the file 
specification for the program listing file; it must 
appear between the comma and the equal sign. 

/E List macro expansions (same as LALL pseudo-op) . 

/F Output binary listing in multiformat (same as .MFRMT 
pseudo-op) . 

/G Output binary listing in halfword format (same as 
.HWFRMT pseudo-op) . 

/H Print HELP text (list of switches and explanations) . 

/L Reinstate listing (same as LIST pseudo-op) . 

/M List only the call and binary produced in a macro 
expansion (same as SALL pseudo-op) . 

/N Suppress error printouts on the terminal. 

/0 End literal with CR-LF or right square bracket (same 
as MLOFF pseudo-op) . 

/P Increase the size of the pushdown list. This switch 
can appear as many times as desired. The pushdown 
list is initially set to a size of 80 (decimal) 
locations; each /P increases the size by 80 
(decimal). /P must appear on the left of the =. 

/Q Suppress Q (questionable) warning errors on the 
listing. /Q must appear on the left of the =. 



(Continued on next page) 
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Table 7-1 (Cont.) 
MACRO Switch Options 



Switch 


Meaning 


/s 


Suppress listing (same as XLIST pseudo-op). 


/T 


Skip to the logical end of the magnetic tape. The /T 




switch must immediately follow the device to which 




the switch refers. 


/u 


Do not generate a . UNV file on DSK. The /U switch 




must appear immediately after the specification for 




the binary program file; that is, it must appear 




between the file specification and the comma. 


/w 


Rewind the magnetic tape. The /W switch must 




immediately follow the device to which the switch 




refers . 


/x 


Suppress listing of macro expansions (same as XALL) . 
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ERRORS AND MESSAGES 

MACRO has three kinds of messages: 

1. Informational messages 

2. Single-character error codes 

3. MCRxxx messages (where xxx is a 3-letter mnemonic code) 

8.1 INFORMATIONAL MESSAGES 

MACRO'S informational messages are printed at the foot of the program 
listing. These messages and their explanations are given in Table 
8-1. 
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Table 8-1 
MACRO Informational Messages 



Message 



Explanation 



ABSLUTE BREAK 
CORE USED 

CPU TIME USED 

ERRORS DETECTED 

HI-SEG. BREAK 

PROGRAM BREAK 

PSECT n BREAK 

UNASSIGNED DEFINED 
AS IF EXTERNAL 

WARNINGS GIVEN 



The highest absolute address over 137. 

The size of the low segment used to 
assemble the source program. 

The CPU time for assembly in minutes and 
seconds. 

The number of errors detected by MACRO 
during assembly (errors marked on the 
listing by single-character codes other 
than Q) . 

The length of the high segment. 

The length of the low segment. 

The length of PSECT n. 

Undefined symbol; treated as EXTERNAL. 



The number of Q errors found. Processing 
is terminated if under BATCH. 
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8.2 SINGLE-CHARACTER ERROR CODES 

Single-character error codes are printed in the program listing near 
the left margin of the line where the error occurs. If more than one 
kind of error occurs in the same line, more than one character will be 
printed; if more than one error of the same kind occurs in the line, 
the code is printed only once. 

Codes for M, P, V, and X errors are typed during Pass 1. 

If you use CREF to produce a cross-referenced listing file, all the 
single-character error codes will appear in the cross-reference table 
as %....x, where x is the code character. 

Table 8-2 gives the single-character error codes and their 
explanations . 
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Table 8-2 
MACRO Single-Character Error Codes 



Code 




Explanation 


A 


Argument error in pseudo-op. This is a broad class of 




errors that can be caused by an improper argument in a 




pseu 


do-op. The A errors include: 




1. 


Symbol used is improperly formed. 




2. 


IFIDN comparison string is too large. 




3. 


OPDEF of macro or SYN. 




4. 


Invalid SIXBIT character. 




5. 


Byte size in BYTE more than 36. 




6. 


RADIX50 code not absolute. 




7. 


End of line of IF reached before < character seen. 




8. 


Assignment made in an address field; for example, 
MOVEI A=10. (However, MOVEI <A=10> is valid.) 




9. 


Assignment of a label; for example, TAG: TAG=1. 




10. 


Missing symbol in SYN. 




11. 


Unknown symbol in SYN. 




12. 


Missing right parenthesis in an index. 




13. 


Missing left parenthesis in a BYTE statement. 




14. 


No comma after repeat count. 




15. 


IRP or IRPC not in a macro. 




16. 


Arqument for IRP or IRPC is not a dummy symbol; for 
example, DEFINE GO (A) IRP B. 




17. 


IRP or IRPC argument is a created symbol. 




18. 


STOPI not in IRP or IRPC. 


D 


Mult 


iply defined symbol. The statement contains a tag 




that 


refers to a multiply defined symbol. The first 




definition is used for assembling the statement. 



(Continued on next page) 
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Table 8-2 (Cont.) 
MACRO Single-Character Error Codes 



Code Explanation 



E Improper use of an EXTERNAL symbol. The E errors include: 

1. Symbol both EXTERNAL and internal. 

2. EXTERNAL symbol used as accumulator register address. 

3. EXTERNAL symbol used with IF. 

4. EXTERNAL symbol used as address for LOC, RELOC, PHASE, 
HISEG, or TWOSEG. 

5. EXTERNAL symbol used for array name or size in ARRAY. 

6. EXTERNAL symbol used as REPEAT count. 

L Literal generates less than 1 or more than 99 words of 
data. 

M Symbol defined more than once; retains its first 
definition. If a symbol is first defined as a variable 
and later as a label, it retains the label definition. 
This error can be caused by multiple appearances of TITLE, 
or TITLE with UNIVERSAL. 

N Number error. The N errors include: 

1. Number exceeds the permitted range. 

2. B shift not absolute. 

3. Digits exceed current radix. If radix is 8, the 
single character 9 is acceptable but the number 19 is 
not acceptable. 

4. Character after up-arrow not B, 0, F, L, D, !, or -. 

5. Illegal expression after E. 

Operation code undefined. It is assembled as zeros. 

P Phase error. In general, the assembler generates the same 
number of program locations in Pass 1 and Pass 2. Any 
discrepancy causes a phase error. 

Phase errors can be caused by incorrect literal 
allocation . 

If a symbol is used as a macro to generate code in Pass 1, 
and is used as a label in Pass 2, a phase error can occur. 

A relocatable label that is defined in a literal and then 
used in an arbitrary expression; MACRO generates a Polish 
expression instead of treating the label as EXTERNAL. 

(Continued on next page) 
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Table 8-2 (Cont.) 
MACRO Single-Character Error Codes 



Code 




Explanation 




Q 


Questionable. This is a broad class of warnings in which 
the assembler finds ambiguous language. Statements 
causing Q errors may not generate correct code. The Q 




errors include: 






1. 


Too many ASCII characters in double quotes ("). 
the first five are used. 


Only 




2. 


Too many SIXBIT characters. Only the first six 
used . 


are 




3. 


Value too large; high-order bits are lost. 






4. 


Illegal expression after E. 






5. 


Illegal control character. 






6. 


Comma detected after all required fields filled; 
example, MOVE 1,2,. 


for 




7. 


HISEG or TWOSEG found after relocatable 
assembled . 


code 




8. 


Instruction memory address operand does not 
either all O's or all l's in its left half; 
example, 1,,0 or -4,,-l. 


have 
for 




9. 


More than 18-bit values used in XWD. 




R 


Relocation error. The R errors include: 






1. 


Expression neither absolute nor relocatable. 






2. 


LOC or RELOC used improperly. 






3. 


Relocatable BLOCK size given. 






4. 


Relocatable accumulator address given. 




S 


PSECT usage error. The S errors include: 






1. 


More than 64 distinct PSECT names used. 






2. 


More than 16 levels of PSECT nesting used. 






3. 


PSECT name given with . ENDPS is not the name of 
current PSECT. 


the 


U 


Und 


efined symbol. 




V 


Symbol used to control the assembler is undefined, 
the definition precede the reference. 


Make 


X 


Error in defining or calling a macro during Pass 1. 
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8.3 MCRxxx MESSAGES 

The MCRxxx messages are issued to the terminal during assembly. (The 
xxx represents a 3-letter code.) 

Any MCRxxx message that is preceded by a question mark is normally 
fatal under batch processing. A few MCRxxx messages are 
informational; these are issued within square brackets. 

Table 8-3 gives all the MCRxxx messages. Each 3-letter code and its 
message are printed in boldface type. For some messages, an 
explanation is printed in lightface type. 
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Table 8-3 
MCRxxx Messages 



Code Message and Explanation 

ATS LINES/PAGE ARGUMENT TOO SMALL 

The argument given must be greater than three to allow space 
for the page heading. 

CAP CORE ALLOCATION PROBLEM WITH MEMORY-RESIDENT UNIVERSALS 

UNIVERSAL programs assembled with the /U switch must have 
the same output specifications as succeeding files. (See 
the pseudo-op UNIVERSAL in Chapter 3.) However, if none of 
the memory-resident UNIVERSALS are to be searched by 
subsequent files in the command sequence, you can clear the 
UNIVERSALs and force the needed memory allocation by typing 
CTRL/C, followed by START. 

CFU CANNOT FIND UNIVERSAL 

Correct the request for the UNIVERSAL file, or assemble the 
required UNIVERSAL file. 

CME COMMAND ERROR 

The last command string contains an error. 

CTL COMMAND LINE TOO LONG 

The last input command string contains more than 200 
characters . 

ECF ERROR READING COMMAND FILE 

This is a file status error. 

EP1 END OF PASS 1 

Manual input is required to begin Pass 2 because input is 
from cards or terminal. 

EPP EXPRESSION PARSING PROBLEM 

An expression was misinterpreted because MACRO interpreted a 
slash as a division operator, or a hyphen as a subtraction 
operator . 

ERU UNEXPECTED END-OF-FILE READING UNIVERSAL FILE 

EWE ERROR WHILE EXPANDING 

MACRO has an internal error in expanding a macro. Rewrite 
the macro, and submit a Software Performance Report. 



(Continued on next page) 
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Table 8-3 (Cont.) 
MCRxxx Messages 



Code Message and Explanation 



IBL INPUT BLOCK TOO LARGE DEVICE 

An input block from the specified device is too large. 
ICP INPUT CHECKSUM OR PARITY ERROR DEVICE 

This is a hard-data error. 
IDE INPUT DATA ERROR DEVICE 

This is a hard-data error. 
ISC ILLEGAL SYNTAX IN CONDITIONAL OR REPEAT 
ISD ILLEGAL SYNTAX IN MACRO DEFINITION 

The macro is improperly defined. 

ISI ILLEGAL SYNTAX IN [IRP or IRPC] INSIDE MACRO 

ISR ILLEGAL SYNTAX IN REPEAT 

LNF LOAD THE NEXT FILE 

The command string specifies the next file device as card 
reader or terminal. Input the file through the appropriate 
device. 

LRE (?) LOOKUP, RENAME, OR ENTER ERROR 

LRE (0) FILE WAS NOT FOUND 

LRE (1) NO DIRECTORY FOR PROJECT-PROGRAMMER NUMBER 

LRE (2) PROTECTION FAILURE 

LRE (3) FILE WAS BEING MODIFIED 

LRE (4) RENAME FILE NAME ALREADY EXISTS 

LRE (5) ILLEGAL SEQUENCE OF UUO'S 

LRE (6) BAD UFD OR BAD RIB 

LRE (7) NOT A SAV FILE 

LRE (10) NOT ENOUGH CORE 

LRE (11) DEVICE NOT AVAILABLE 

LRE (12) NO SUCH DEVICE 

LRE (13) NO TWO RELOC REG. CAPABILITY 



(Continued on next page) 
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Table 8-3 (Cont.) 
MCRxxx Messages 



Code 



Message and Explanation 



LRE 


(14) 


LRE 


(15) 


LRE 


(16) 


LRE 


(17) 


LRE 


(20) 


LRE 


(21) 


LRE 


(22) 


LRE 


(23) 


LRE 


(24) 


LRE 


(25) 


LRE 


(26) 


LTL 


LITE 


MDE 


MONI 



MPA 
NEC 

NES 
NUF 

OBL 

OCP 

ODE 

OQE 
OUF 



NO ROOM OR QUOTA EXCEEDED 

WRITE LOCK ERROR 

NOT ENOUGH MONITOR TABLE SPACE 

PARTIAL ALLOCATION ONLY 

BLOCK NOT FREE ON ALLOCATION 

CAN'T SUPERSEDE (ENTER) AN EXISTING DIRECTORY 

CAN'T DELETE (RENAME) A NON-EMPTY DIRECTORY 

SFD NOT FOUND 

SEARCH LIST EMPTY 

SFD NESTED TOO DEEPLY 

NO-CREATE ON FOR SPECIFIED PATH 
LITERAL TOO LONG 

MONITOR DETECTED SOFTWARE INPUT ERROR DEVICE 
The input file is not in a valid mode. 
MISSING CLOSE PAREN AROUND ARG LIST 
INSUFFICIENT CORE 

Not enough memory is available to assemble the program. 
NO END STATEMENT ENCOUNTERED ON INPUT FILE 
NOT A REAL UNIVERSAL FILE 
No such UNIVERSAL file was found. 
OUTPUT BLOCK TOO LARGE DEVICE 
This is a file-status error. 
OUTPUT CHECKSUM OR PARITY ERROR DEVICE 
This is a hard-data error. 
OUTPUT DATA ERROR DEVICE 
This is a hard-data error. 
OUTPUT QUOTA EXCEEDED ON DEVICE 
UNIVERSAL FILE DEFAULT ARGUMENTS LOST, REASSEMBLE 



(Continued on next page) 
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Table 8-3 (Cont.) 
MCRxxx Messages 



Code Message and Explanation 

PDL PDP OVERFLOW, TRY /P 

See the /P switch in Table 7-1. 
PET INPUT PHYSICAL END OF TAPE DEVICE 
PGE PRGEND ERROR 

See the PRGEND pseudo-op for proper use of PRGEND. 

PTC POLISH TOO COMPLEX 

A Polish expression is too complex for MACRO to handle. 
Restructure or split the expression. 

SOC STATEMENT OUT OF ORDER .COMMON 

The .COMMON pseudo-op must precede all statements that 
generate code,, and all references to the COMMON block. 

STO SEARCH TABLE OVERFLOW, CANNOT SEARCH UNIVERSAL 

TMU TOO MANY UNIVERSALS 

Too many UNIVERSAL files are being searched. The number 
permitted is an assembly parameter; it can be increased by 
reassembling MACRO. 

UVS UNIVERSAL VERSION SKEW, REASSEMBLE UNIVERSAL 

The UNIVERSAL file was assembled with a later version of 
MACRO than you are using now. Reassemble the UNIVERSAL 
file. 

UWU UNABLE TO WRITE UNIVERSAL FILE 

WLE OUTPUT WRITE-LOCK ERROR DEVICE 
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CHAPTER 9 
PROGRAMMING CONSIDERATIONS 



The previous chapters of this manual define the MACRO language 

elements. In particular, the pseudo-op definitions in Chapter 3 

define many of MACRO'S most important features. However, the 

usefulness of some pseudo-ops can be seen only in the context of a 
"family" of pseudo-ops. 

In this chapter, we discuss three such families of pseudo-ops. The 
programming features concerned are: 

1. Program segmentation 

2. UNIVERSAL files 

3. Conditional assembly 



9.1 PROGRAM SEGMENTATION 

MACRO'S relocation counters can accommodate three types of programs: 

1. A single-segment program uses only one relocation counter. 

2. A two-segment program also uses one relocation counter, and 
is characterized by its use of the TWOSEG pseudo-op. 

3. A program with PSECTS can use many relocation counters, and 
is characterized by its use of the .PSECT and .ENDPS 
pseudo-ops . 



9.1.1 Single-Segment Programs 

A single-segment program uses only one relocation counter. This 
counter can be used to assign any address from to 777777. The 
initial setting of the counter is 0. 

As MACRO assembles your program, it places code and data at the 
address given by the current value of the relocation counter, 
incrementing the counter's value for each word assembled. 

For example, a statement can require assembly of one word of code, 
incrementing the relocation counter by 1. Another statement can 
require assembly of five words of code, incrementing the relocation 
counter by 5. Still another statement may not generate code, leaving 
the relocation counter unchanged. 
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You can reset the value of the relocation counter by using the 
pseudo-op RELOC with an argument. For example, using RELOC A sets the 
value of the relocation counter to the value of A. 

In the following example, 100 words are allocated for a table, 
incrementing the relocation counter by 100. Then the table length is 
calculated as TABLEN. A RELOC TABLE returns to the top of the table, 
where the first three words are initialized. Finally a RELOC 
TABLE+TABLEN sets the relocation to the foot of the table to continue 
assembly. 



OOOOOO' 

000000' 
000000' 
000001 ' 
000002' 
000100' 



table: block ioo 



000100 

000000 000001 
000000 000002 
000000 000003 



TABLEN=. -TABLE 
RELOC TABLE 
EXP 1»2>3 



^Allocate table 
JTable lenslth 
fTop of table 
Jlnit first 3 



RELOC TABLE+TABLEN J Continue 



9.1.2 Two-Segment Programs 

By using the TWOSEG pseudo-op, you can divide your program into a high 
segment and a low segment. This pseudo-op must precede any statement 
in your program that generates code. 

The TWOSEG pseudo-op tells MACRO that there will be two segments, and 
MACRO generates a REL Block Type 3, which tells LINK to expect two 
segments for loading. 

You can use TWOSEG either with or without an address argument. There 
are important differences between the two: 

1. TWOSEG without an argument specifies that the high segment 
begins at the address 400000. The initial value of the 
relocation counter is at the address in the low segment. 

2. TWOSEG with an argument specifies that the high segment 
begins at the given address, and further specifies that the 
initial value of the relocation counter is that address. 
(The given address is reduced to the next lower multiple of 
2000 octal; if this result is 0, MACRO treats the TWOSEG as 
if no argument were given.) 

The high-segment starting address divides all code into two segments. 

MACRO and LINK consider all code at addresses above the high-segment 

address to be in the high segment, and all other code to be in the low 
segment . 

MACRO always remembers the value the relocation counter had before the 
last RELOC found. (This stored value is initially 0.) 

Therefore in a two-segment program, you can begin in one segment, and 
then RELOC to the other. From then on, you can switch segments simply 
by using RELOC with no argument. MACRO will begin assigning addresses 
at the first unused location in the opposite segment. 
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For example, 

400000' 
000000' 
000001' 
400000' 
400000' 
400001' 
000002' 
000002' 
000003' 
400002' 
400002' 
400003' 



000000 
000000 

000000 
000000 

000000 
000000 

000000 
000000 



000001 
000002 

000003 
000004 

000005 
000006 

000007 
000010 



TWOSEG 
EXP 1,2 

RELOC 400000 
EXP 3,4 

RELOC 
EXP 5,6 

RELOC 
EXP 7,10 



?Lo-sed 
5 Hi™ isesj 

f Lo--se<3 

JMi-sesl 



9.1.3 Programs With PSECTs 

You can construct a program having up to 64 segments by using the 
.PSECT and .ENDPS pseudo-ops. These pseudo-ops control switching 
among program segments (PSECTs) . 

Each PSECT has its own relocation counter; each is separately 
relocated at load time. Therefore a program with two PSECTs is 
different from a two-segment program in that the PSECTed program has 
two relocation counters, while the two-segment program has only one. 

The pseudo-op .PSECT specifies that code should be assembled for a 
given PSECT. For example, .PSECT A specifies that code is to be 
assembled in the program segment (PSECT) called A. The pseudo-op 
.ENDPS ends assembly in the current PSECT. 

PSECTs can be nested up to 16 levels. In a nested PSECT, the .ENDPS 
pseudo-op begins assembly in the next outer PSECT; in an unnested 
PSECT, .ENDPS begins assembly in the blank PSECT. (You can think of 
the blank PSECT as being outside of all your explicitly declared 
PSECTs.) 

Here is an example showing three PSECTs (A, B, and C) : 



000000 '00 000000 000001 EXP 1,2 

000001 '00 000000 000002 

000000 '01 .PSECT A 

000000 '01 000000 000003 EXP 3,4 

000001 '01 000000 000004 

000000 '02 .PSECT B 

000000 '02 000000 000005 EXP 5,6 

000001 '02 000000 000006 

000002 '01 .ENDPS B 

000002 '01 000000 000007 EXP 7,10 

000003'01 000000 000010 

000002 '00 .ENDPS A 

000002'00 000000 000011 EXP 11,12 

000003'00 000000 000012 

000000 '03 .PSECT C 

000000'03 000000 000013 EXP 13,14 

000001 '03 000000 000014 

000004 '00 .ENDPS C 

000002 '02 .PSECT B 

000002'02 000000 000015 EXP 15,16 

000003'02 000000 000016 

000004 '00 .ENDPS B 



J Blank PSECT 
Jlst PSECT 

,2nd PSECT (nested) 

ilst PSECT 

J Blank PSECT 

J 3rd PSECT 



i Blank PSECT 
»2nd PSECT 



t Blank PSECT 
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In the example, the blank PSECT surrounds everything. Embedded in the 
blank PSECT are: 

1. PSECT A (which also nests some of PSECT B) 

2. PSECT C 

3. Another segment of PSECT B 

Each PSECT used in a program generates the PSECT name as a global 
symbol. At load time, this symbol will take the value of the origin 
specified for the PSECT. 

When LINK loads your program, all the parts of the same PSECT are 
loaded together. These parts can be in more than one program, or in 
more than one file. For details of LINK'S handling of PSECTs at load 
time, see the LINK Reference Manual. 



9.2 UNIVERSAL FILES 

A UNIVERSAL file contains direct-assignment symbol definitions. The 
symbols defined can have any attributes. 

A UNIVERSAL file is convenient because it can contain definitions that 
you want for many programs. Those programs can then obtain the 
definitions by your use of the SEARCH pseudo-op. This searching adds 
to the assembly only those definitions that are needed; other 
definitions in the UNIVERSAL file are not used. 

To build a UNIVERSAL file from a MACRO source file, insert the 
pseudo-op 

UNIVERSAL filespec 

where the filespec gives the file for output of the UNIVERSAL file. 
This file will contain all the symbols and definitions given in the 
program. 

Another program can obtain these definitions if it contains the SEARCH 
pseudo-op: 

SEARCH filespec 

where filespec names the UNIVERSAL file. At the end of Pass 1 
assembly, MACRO will search the UNIVERSAL file for any undefined 
symbols. If a definition is found in the UNIVERSAL file, MACRO moves 
it into the symbol tables of the current program. 

For example, a UNIVERSAL file can contain definitions for register 
mnemonics : 

UNIVERSAL REGS 

000000 R0=0 

000001 Rl=l 

000002 R2=2 

000003 R3=3 

000004 Tl=4 

000005 T2=5 

000016 SP=1A 

000017 P=17 
END 
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Then another assembly can obtain these by using the SEARCH 
pseudo-op: 

SEARCH REGS 



REGS 



000000' 
000001' 
000002' 
000003' 
000004' 
000005' 
000006' 
000007' 



000 00 00 
000 01 00 
000 02 00 
000 03 00 
000 04 00 
000 05 00 
000 16 00 
000 17 00 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



z 


RO 


z 


Rl 


z 


R2 


z 


R3 


z 


Tl 


z 


T2 


z 


SP 


z 


P» 



A UNIVERSAL file can contain definitions for any user-defined symbols. 
You may find it convenient to build UNIVERSAL files containing macros, 
OPDEFs, and direct-assignment symbols that you use often in your 
programs. 



An example of a UNIVERSAL program appears in the program examples 
Appendix D. 



in 



9.3 CONDITIONAL ASSEMBLY 

Using conditional assembly in your programs can make programming 
easier, and can make your assembled programs shorter. The pseudo-ops 
used for conditional assembly are IRP, IRPC, STOPI, .IF, .IFN, and the 
IFx group. IRP, IRPC, and STOPI are discussed fully in Chapter 3 and 
Section 5.6. 

We will confine the discussion here to a few classic uses of the 
remaining conditional assembly pseudo-ops. 

The first of these is the use of IFNDEF to establish default switch 
settings for a program. The example here is from the MACRO program 
itself, and concerns assembly of F40-switch-dependent symbols. 

Near the beginning of the code, MACRO has the statement: 

IFNDEF F40 <F40==0> 

This statement has effect only if the symbol F40 is not defined, in 
which case the statement F40==0 is assembled. This sets the F40 
switch to "off." 

But if a file defining F40 is assembled with (and before) the MACRO 
source file, then the statement F40==0 is not assembled, leaving the 
"outside" definition in force. 

Therefore the statement IFNDEF F40 <F40==0> serves as a default 
definition for F40, and this default is used only if no other 
definition overrides it. 

Another application of conditional assembly is connected with the 

symbol F40. In MACRO'S program segments on symbol searching, some 

symbols will be defined (and therefore found in the search) only if 
the F40 switch is "on." 
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Here is how MACRO'S code handles these symbols, 
sequence as follows: 



There is 



code 



; MACRO TO HANDLE F40 UUOS 

IFE F40f < 
DEFINE XF (SBrCD) <» 

IFN F40> <SYN X>XF> 



rNULL MACRO 

f USUAL X MACRO 



The "usual X macro" is merely a macro to set up symbols to be defined 
and the code to assemble on finding them. The macro XF will be used 
to handle definitions for F40 UUOs. 

Now if the F40 switch is on, the macro XF is made synonymous with the 
macro X, and the F40 UUOs are defined in the same way as other 
operators. But if the F40 switch is off, XF is made a null macro so 
that all the F40 UUOs are ignored during assembly and are not defined 
to MACRO. 

The assembly of the F40 UUOs depends on the value of the F40 switch, 
and the value of the switch depends on its definition. If MACRO had 
no IFNDEF F40 statement, an "outside" file would have to define the 
switch at every assembly of MACRO. But the default definition allows 
assembly of MACRO alone, and the outside file is needed only to turn 
the switch on. 



Examples of conditional assembly are shown in the program examples 
Appendix D. 



in 
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APPENDIX A 
MACRO CHARACTER SETS 



Table A-l gives the 101 ASCII characters allowed in MACRO and their 
octal ASCII codes; the 64 SIXBIT characters and their octal SIXBIT 
codes; and the 40 RADIX50 characters and their octal RADIX50 codes. 



Table A-l 
MACRO Character Sets 







ASCII 


SIXBIT 


RADIX50 


Character 




Code 


Code 


Code 


(horizontal 


tab) 


Oil 






(linefeed) 




012 






(vertical tab) 


013 






(formfeed) 




014 






(carriage-re 


turn) 


015 






(CTRL/Z) 




032 






(CTRL/_) 




037 






(blank) 
i 




040 
041 


00 
01 


00 


■I 




042 


02 




# 




043 


03 




$ 




044 


04 


46 


% 




045 


05 


47 


& 
i 

( 
) 




046 
047 

050 
051 


06 
07 

10 
11 




* 




052 


12 




+ 




053 


13 




i 




054 


14 




- 




055 


15 




. 




056 


16 


45 


/ 




057 


17 





(Continued on next page) 
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Table A-l (Cont.) 
MACRO Character Sets 





ASCII 


SIXBIT 


RADIX50 


Character 


Code 


Code 


Code 





060 


20 


01 


1 


061 


21 


02 


2 


062 


22 


03 


3 


063 


23 


04 


4 


064 


24 


05 


5 


065 


25 


06 


6 


066 


26 


07 


7 


067 


27 


10 


8 


070 


30 


11 


9 


071 


31 


12 


: 


072 


32 




i 


073 


33 




< 


074 


34 




= 


075 


35 




> 


076 


36 




? 


077 


37 




@ 


100 


40 




A 


101 


41 


13 


B 


102 


42 


14 


C 


103 


43 


15 


D 


104 


44 


16 


E 


105 


45 


17 


F 


106 


46 


20 


G 


107 


47 


21 


H 


110 


50 


22 


I 


111 


51 


23 


J 


112 


52 


24 


K 


113 


53 


25 


L 


114 


54 


26 


M 


115 


55 


27 


N 


116 


56 


30 





117 


57 


31 


P 


120 


60 


32 


Q 


121 


61 


33 


R 


122 


62 


34 


S 


123 


63 


35 


T 


124 


64 


36 


U 


125 


65 


37 


V 


126 


66 


40 


W 


127 


67 


41 



(Continued on next page) 
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Table A-l (Cont.) 
MACRO Character Sets 





ASCII 


SIXBIT 


RADIX50 


Character 


Code 


Code 


Code 


X 


130 


70 


42 


Y 


131 


71 


43 


Z 


132 


72 


44 


[ 


133 


73 




\ 


134 


74 




I 


135 


75 






136 


76 




— 


137 


77 




a 


141 






b 


142 






c 


143 






d 


144 






e 


145 






f 


146 






g 


147 






h 


150 






i 


151 






J 


152 






k 


153 






1 


154 






m 


155 






n 


156 









157 






P 


160 






q 


161 






r 


162 






s 


163 






t 


164 






u 


165 






V 


166 






w 


167 






X 


170 






y 


171 






z 


172 
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MACRO SPECIAL CHARACTERS 



Characters and combinations having special interpretations in MACRO 
are given in Table B-l. These interpretations apply only in the 
contexts described. In particular, they do not apply within text 
strings or comment fields. 

For each usage of special characters, a cross-reference to a text 

discussion is given in the rightmost column of the table. For 

references to pseudo-ops, only the pseudo-op name is given; all 
pseudo-ops are discussed in alphabetical order in Chapter 3. 



B-l 



Table B-l 
Interpretations of Special Characters 



03 
I 



Characters 


Context 


Form 


Interpretation 


Discussed in 












Section 


B 


between two 


mBn 


causes the 


binary representation 






integer 




of m to be 


placed with rightmost 






expressions 




bit at bit 


n (decimal ) . 


2.2.6 


~B 


before integer 
expression 


~Bn 


shows that 


n is a binary number. 


2.2.2 


~D 


before integer 
expression 


~Dn 


shows that 


n is a decimal number. 


2.2.2 


E 


between floating- 


fE+n 


mul t ipl ies 


f by the 






point decimal 




+nth power 


of 10. 






number and signed 












decimal integer 








2.2.5 


~F 


before integer 


~Fn 


shows that 


n is a fixed- 






expression 




point decimal number. 


2.2.4 


G 


after integer 


nG 


suffixes nine zeros to n. 


2.2.3 


K 


after integer 


nK 


suffixes three zeros to n. 


2.2.3 


~L 


before decimal 
integer 


~Ln 


generates the number of leading 
zeros in the binary representa- 






expression 




tion of n. 




2.2.8 


M 


after integer 


nM 


suffixes six zeros to n. 


2.2.3 



2 
> 
O 
50 
O 

01 

M 
O 
i-l 

> 

O 

> 

> 
o 

m 
w 
en 
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Table B-l (Cont.) 
Interpretations of Special Characters 



Characters Context 



Form 



Interpretation 



Discussed in 
Section 






before integer 
expression 

after symbol 

after symbol 

after symbol 

after symbol 



before end of 
line 

before end of 
line (usually 
in a macro) 

as expression 



embedded in 
numerals 



~On 

sym : 
sym : : 

sym : ! 

sym : : ! 

; text 
; ; text 



int . f r 



shows that n is an octal number. 



shows that sym is a label. 

shows that sym is a 
global INTERNAL label. 

shows that sym is a label, 

but not to be output by debugger 

shows that sym is a global 
INTERNAL label, but not to be 
output by debugger. 

shows that text is a comment. 



shows that text is a comment 
to be printed in the macro 
definition but not at call. 

generates current value of the 
location counter. 

shows that int.fr is a 
floating-point decimal number. 



2.2.2 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 
4.4, 4.5 
4.4, 4.5 

2.3, 4.6 
2.2.5 



36 
> 
O 

w 
o 

to 
*n 

w 
o 

M 

> 

o 

EC 
> 
50 
> 
O 

M 
W 
W 
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Interpretations of Special Characters 



03 
4* 



Characters 


Context 


Form 


Interpretation 


Discussed in 
Section 


/ 


among numbers 


/ 


delimits operands, accumulator, 


4.3, 4.5 




and symbols 




arguments . 


5.1, 5.2 


f t 


among numbers 
and symbols 


i i 


delimits a null macro argument. 


5.2, 5.5 


r i 


between two 


lhw, ,rhw 


delimits left halfword (lhw) 






expressions 




from right halfword (rhw). 


2.5.4.1 


1 


between two 


AIB 


generates the logical 






expressions 




inclusive OR of A and B. 


2.5.2 


~ 1 


between two 


A~!B 


generates the logical 






expressions 




exclusive OR of A and B. 


2.5.2 


& 


between two 


A&B 


generates the logical 






expressions 




AND of A and B. 


2.5.2 


~- 


before expression 


~-A 


generates one's complement of value 
of A (logical NOT) . 


2.5.2 


* 


between two 
expressions 


A*B 


generates product of A and B. 


2.5.1 


/ 


between two 
expressions 


A/B 


generates quotient of A by B. 


2.5.1 


+ 


between two 
expressions 


A+B 


generates sum of A and B. 


2.5.1 



SB 
> 

» 

o 

en 
*a 
ra 
o 

H 
> 

n 

> 

? 

n 
•-3 
m 
w 
en 
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03 

I 







Interpre 


Table B-l (Cont.) 
tations of Special Characters 




Characters 


Context 


Form 




Interpretation 


Discussed in 
Section 


- 


between two 
expressions 


A-B 




generates difference of A and B. 


2.5.1 


- 


before an 
expression 


-A 




generates the two's complement 
of the value of A. 


2.2.1, 2.2.4, 
2.2.5 


■I ii 


around text 


"text" 




shows that text is a 7-bit ASCII 
string, to be right justified 
in field of five characters. 


ASCII, ASCIZ 


■ i 


around text 


•text 1 




shows that text is a SIXBIT 
string, to be right justified 
in field of six characters. 


SIXBIT 


i 


adjoining dummy 
argument in 
macro body 


text 'dar 

or 
darg ' tex 


g 
t 


concatenates passed argument to 
text at call to macro. 


5.4 


# 


after symbol 


sym# 




shows that sym is a variable 
symbol, whose address is usually 
at the end of the binary program. 


2.4.3 


## 


after symbol 


sym## 




shows that sym is a global 
EXTERNAL symbol. 


2.4.5.2 


\ 


prefixed to 
expression 
in macro call 


\expr 




directs that the argument passed be 
the string for the ASCII value of 
expr in the current radix. 


5.7.1 



> 

» 
o 

en 
»o 
a 
o 

M 
> 
IT* 

o 

SB 
> 

5 

n 

•-i 

pa 
» 
en 
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Characters 


Context 


Form 


Interpretation 


Discussed in 
Section 


V 


prefixed to 
expression 
in macro call 


\ 'expr 


directs that the argument passed be 
the string whose SIXBIT code is 
the value of expr. 


5.7.3 


\" 


prefixed to 
expression 
in macro call 


V'expr 


directs that the argument passed be 
the string whose ASCII code is 
the value of expr. 


5 .7 . 3 


CTRL/— 
(CONTROL- 
underscore) 


before CR-LF 


CTRL/_ 


continues argument to next line; does 
not operate across end-of-macro . 


' 5.2.1 


— 


between two 
expressions 


A_B 


shifts the binary representation 

of A to the left B positions. 

(If B is negative, shift is to right.) 


2.2.6 


@ 


prefixed to 
address 


@address 


sets bit 13 of the instruction word, 
indicating indirect addressing. 


4.7.1 


% 
( ) 


1st character 

of dummy argument 

in macro definition 


%darg 


directs that %darg be replaced by a 
created symbol at macro call; MACRO 
will substitute a different symbol 
for it on each use of the macro. 


5.5.2 




\ • • • ) 


encloses index field; encloses dummy 
arguments in macro definition; 
quotes characters for macro 
argument handling; swaps the two 
halves of enclosed value. 


4.7.1, 5.1 
5.2.2 



3C 
> 

n 
» 
o 

en 

a 
o 

M 

> 

o 

as 
> 

3 

O 

►■3 
W 
M 
W 
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i 



Characters 


Context 


Form 


Interpretation 


Discussec 
Section 


1 in 


< > 




<. . . > 


nests expressions; encloses 
conditional assembly code; 












encloses code in REPEAT, IRP, 
and IRPC pseudo-ops; encloses 


2.5.4 










macrobody in DEFINE pseudo-op; 


IFx, .IF, 


r .IFN, 








quotes characters for macro 


REPEAT, IRP, 








argument handling; forces 


IRPC, DEFINE, 








evaluation of symbol. 


5.1, 5.2 


2 


[ ] 




[...] 


delimits literals; delimits argument 












in ARRAY, .COMMON, and OPDEF 


2.3, ARRAY, 








pseudo-ops; quotes characters 


.COMMON, 


OPDEF, 








for macro argument handling. 


5.2.2 




= 


between symbol 


sym=exp 


assigns value of exp to sym. 








and expression 






2.4.2.2, 


4.5 


= = 


between symbol 


sym==exp 


assigns value of exp to sym but 








and expression 




sym is not output by debugger. 


2.4.2.2, 


4.5 


= ; 


between symbol 


sym=:exp 


assigns value of exp to sym and 








and expression 




declares sym as global INTERNAL. 


2.4.2.2, 


4.5 


= =: 


between symbol 
and expression 


sym== :exp 


assigns value of exp to sym and 
declares sym as global INTERNAL, 












but sym is not output by debugger. 


2.4.2.2, 


4.5 



3S 
> 
O 

O 

W 

M 
O 

> 

o 

33 
> 

O 

ra 
en 



APPENDIX C 
MACRO-DEFINED MNEMONICS 



This appendix contains tables showing all of MACRO'S defined mnemonics 
and the code they generate. These mnemonics, together with the 
pseudo-ops and the special characters given in Appendix B, make up the 
entire MACRO language. 



NOTE 

Throughout this appendix, the following 
notes apply to the tables: 

* Indicates mnemonic defined only if MACRO 
is assembled with the KL10 switch on. 

** Indicates mnemonic defined only if MACRO 
is assembled with the KI10 switch on. 

*** Indicates mnemonic defined only if MACRO 
is assembled with the F40 switch on. 



C.l MACHINE INSTRUCTION MNEMONICS 

Table C-l shows MACRO'S machine instruction mnemonics and the code 
assembled by each mnemonic. See Section 4.7 for a discussion of 
machine instructions used in programs. 



C-l 



MACRO-DEFINED MNEMONICS 



Table C-l 
Machine Instruction Mnemonics 



270 


00 00 


000000 


ADD 


303 


00 00 


000000 


CAILE 


273 


00 00 


000000 


ADDB 


306 


00 00 


000000 


CAIN 


271 


00 00 


000000 


ADDI 


310 


00 00 


000000 


CAM 


272 


00 00 


000000 


ADDM 


314 


00 00 


000000 


CAMA 


133 


00 00 


000000 


*ADJBP 


312 


00 00 


000000 


CAME 


105 


00 00 


000000 


*ADJSP 


317 


00 00 


000000 


CAMG 


404 


00 00 


000000 


AND 


315 


00 00 


000000 


CAMGE 


407 


00 00 


000000 


ANDB 


311 


00 00 


000000 


CAML 


410 


00 00 


000000 


ANDCA 


313 


00 00 


000000 


CAMLE 


413 


00 00 


000000 


ANDCAB 


316 


00 00 


000000 


CAMN 


411 


00 00 


000000 


ANDCAI 


400 


00 00 


000000 


CLEAR 


412 


00 00 


000000 


ANDCAM 


403 


00 00 


000000 


CLEARB 


440 


00 00 


000000 


ANDCB 


401 


00 00 


000000 


CLEARI 


443 


00 00 


000000 


ANDCBB 


402 


00 00 


000000 


CLEARM 


441 


00 00 


000000 


ANDCBI 


114 


00 00 


000000 


*DADD 


442 


00 00 


000000 


ANDCBM 


117 


00 00 


000000 


*DDIV 


420 


00 00 


000000 


ANDCM 


110 


00 00 


000000 


**DFAD 


423 


00 00 


000000 


ANDCMB 


113 


00 00 


000000 


**DFDV 


421 


00 00 


000000 


ANDCMI 


112 


00 00 


000000 


**DFMP 


422 


00 00 


000000 


ANDCMM 


131 


00 00 


000000 


DFN 


405 


00 00 


000000 


ANDI 


111 


00 00 


000000 


**DFSB 


406 


00 00 


000000 


ANDM 


234 


00 00 


000000 


DIV 


253 


00 00 


000000 


AOBJN 


237 


00 00 


000000 


DIVB 


252 


00 00 


000000 


AOBJP 


235 


00 00 


000000 


DIVI 


340 


00 00 


000000 


AOJ 


236 


00 00 


000000 


DIVM 


344 


00 00 


000000 


AOJA 


120 


00 00 


000000 


**DMOVE 


342 


00 00 


000000 


AOJE 


124 


00 00 


000000 


**DMOVEM 


347 


00 00 


000000 


AOJG 


121 


00 00 


000000 


**DMOVN 


345 


00 00 


000000 


AOJGE 


125 


00 00 


000000 


**DMOVNM 


341 


00 00 


000000 


AOJL 


116 


00 00 


000000 


*DMUL 


343 


00 00 


000000 


AOJLE 


137 


00 00 


000000 


DPB 


346 


00 00 


000000 


AOJN 


115 


00 00 


000000 


*DSUB 


350 


00 00 


000000 


AOS 


444 


00 00 


000000 


EQV 


354 


00 00 


000000 


AOSA 


447 


00 00 


000000 


EQVB 


352 


00 00 


000000 


AOSE 


445 


00 00 


000000 


EQVI 


357 


00 00 


000000 


AOSG 


446 


00 00 


000000 


EQVM 


355 


00 00 


000000 


AOSGE 


250 


00 00 


000000 


EXCH 


351 


00 00 


000000 


AOSL 


123 


00 00 


000000 


♦EXTEND 


353 


00 00 


000000 


AOSLE 


140 


00 00 


000000 


FAD 


356 


00 00 


000000 


AOSN 


143 


00 00 


000000 


FADB 


320 


00 00 


000000 


ARG 


141 


00 00 


000000 


FADL 


240 


00 00 


000000 


ASH 


142 


00 00 


000000 


FADM 


244 


00 00 


000000 


ASHC 


144 


00 00 


000000 


FADR 


251 


00 00 


000000 


BLT 


147 


00 00 


000000 


FADRB 


300 


00 00 


000000 


CAI 


145 


00 00 


000000 


FADRI 


304 


00 00 


000000 


CAIA 


146 


00 00 


000000 


FADRM 


302 


00 00 


000000 


CAIE 


170 


00 00 


000000 


FDV 


307 


00 00 


000000 


CAIG 


173 


00 00 


000000 


FDVB 


305 


00 00 


000000 


CAIGE 


171 


00 00 


000000 


FDVL 


301 


00 00 


000000 


CAIL 


172 


00 00 


000000 


FDVM 



(Continued on Next Page) 



C-2 



MACRO-DEFINED MNEMONICS 



Table C-l (Cont.) 
Machine Instruction Mnemonics 



174 


00 00 


000000 


FDVR 


547 


00 00 


000000 


HLRS 


177 


00 00 


000000 


FDVRB 


554 


00 00 


000000 


HLRZ 


175 


00 00 


000000 


FDVRI 


555 


00 00 


000000 


HLRZI 


176 


00 00 


000000 


FDVRM 


556 


00 00 


000000 


HLRZM 


126 


00 00 


000000 


**FIXR 


557 


00 00 


000000 


HLRZS 


127 


00 00 


000000 


**FLTR 


504 


00 00 


000000 


HRL 


160 


00 00 


000000 


FMP 


534 


00 00 


000000 


HRLE 


163 


00 00 


000000 


FMPB 


535 


00 00 


000000 


HRLEI 


161 


00 00 


000000 


FMPL 


536 


00 00 


000000 


HRLEM 


162 


00 00 


000000 


FMPM 


537 


00 00 


000000 


HRLES 


164 


00 00 


000000 


FMPR 


505 


00 00 


000000 


HRLI 


167 


00 00 


000000 


FMPRB 


506 


00 00 


000000 


HRLM 


165 


00 00 


000000 


FMPRI 


524 


00 00 


000000 


HRLO 


166 


00 00 


000000 


FMPRM 


525 


00 00 


000000 


HRLOI 


150 


00 00 


000000 


FSB 


526 


00 00 


000000 


HRLOM 


153 


00 00 


000000 


FSBB 


527 


00 00 


000000 


HRLOS 


151 


00 00 


000000 


FSBL 


507 


00 00 


000000 


HRLS 


152 


00 00 


000000 


FSBM 


514 


00 00 


000000 


HRLZ 


154 


00 00 


000000 


FSBR 


515 


00 00 


000000 


HRLZI 


157 


00 00 


000000 


FSBRB 


516 


00 00 


000000 


HRLZM 


155 


00 00 


000000 


FSBRI 


517 


00 00 


000000 


HRLZS 


156 


00 00 


000000 


FSBRM 


540 


00 00 


000000 


HRR 


132 


00 00 


000000 


FSC 


570 


00 00 


000000 


HRRE 


500 


00 00 


000000 


HLL 


571 


00 00 


000000 


HRREI 


530 


00 00 


000000 


HLLE 


572 


00 00 


000000 


HRREM 


531 


00 00 


000000 


HLLEI 


573 


00 00 


000000 


HRRES 


532 


00 00 


000000 


HLLEM 


541 


00 00 


000000 


HRRI 


533 


00 00 


000000 


HLLES 


542 


00 00 


000000 


HRRM 


501 


00 00 


000000 


HLLI 


560 


00 00 


000000 


HRRO 


502 


00 00 


000000 


HLLM 


561 


00 00 


000000 


HRROI 


520 


00 00 


000000 


HLLO 


562 


00 00 


000000 


HRROM 


521 


00 00 


000000 


HLLOI 


563 


00 00 


000000 


HRROS 


522 


00 00 


000000 


HLLOM 


543 


00 00 


000000 


HRRS 


523 


00 00 


000000 


HLLOS 


550 


00 00 


000000 


HRRZ 


503 


00 00 


000000 


HLLS 


551 


00 00 


000000 


HRRZI 


510 


00 00 


000000 


HLLZ 


552 


00 00 


000000 


HRRZM 


511 


00 00 


000000 


HLLZI 


553 


00 00 


000000 


HRRZS 


512 


00 00 


000000 


HLLZM 


133 


00 00 


000000 


IBP 


513 


00 00 


000000 


HLLZS 


230 


00 00 


000000 


IDIV 


544 


00 00 


000000 


HLR 


233 


00 00 


000000 


IDIVB 


574 


00 00 


000000 


HLRE 


231 


00 00 


000000 


IDIVI 


575 


00 00 


000000 


HLREI 


232 


00 00 


000000 


IDIVM 


576 


00 00 


000000 


HLREM 


136 


00 00 


000000 


IDPB 


577 


00 00 


000000 


HLRES 


134 


00 00 


000000 


ILDB 


545 


00 00 


000000 


HLRI 


220 


00 00 


000000 


IMUL 


546 


00 00 


000000 


HLRM 


223 


00 00 


000000 


IMULB 


564 


00 00 


000000 


HLRO 


221 


00 00 


000000 


IMULI 


565 


00 00 


000000 


HLROI 


222 


00 00 


000000 


IMULM 


566 


00 00 


000000 


HLROM 


434 


00 00 


000000 


IOR 


567 


00 00 


000000 


HLROS 


437 


00 00 


000000 


IORB 
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435 


00 00 


000000 


IORI 


471 


00 00 


000000 


ORCBI 


4 36 


00 00 


000000 


IORM 


472 


00 00 


000000 


ORCBM 


255 


00 00 


000000 


JFCL 


464 


00 00 


000000 


ORCM 


243 


00 00 


000000 


JFFO 


467 


00 00 


000000 


ORCMB 


267 


00 00 


000000 


JRA 


465 


00 00 


000000 


ORCM I 


254 


00 00 


000000 


JRST 


466 


00 00 


000000 


ORCMM 


266 


00 00 


000000 


JSA 


435 


00 00 


000000 


ORI 


265 


00 00 


000000 


JSP 


436 


00 00 


000000 


ORM 


264 


00 00 


000000 


JSR 


262 


00 00 


000000 


POP 


104 


00 00 


000000 


JSYS 


263 


00 00 


000000 


POPJ 


320 


00 00 


000000 


JUMP 


261 


00 00 


000000 


PUSH 


324 


00 00 


000000 


JUMPA 


260 


00 00 


000000 


PUSHJ 


322 


00 00 


000000 


JUMPE 


241 


00 00 


000000 


ROT 


327 


00 00 


000000 


JUMPG 


245 


00 00 


000000 


ROTC 


325 


00 00 


000000 


JUMPGE 


424 


00 00 


000000 


SETA 


321 


00 00 


000000 


JUMPL 


427 


00 00 


000000 


SETAB 


323 


00 00 


000000 


JUMPLE 


425 


00 00 


000000 


SETAI 


326 


00 00 


000000 


JUMPN 


426 


00 00 


000000 


SETAM 


135 


00 00 


000000 


LDB 


450 


00 00 


000000 


SETCA 


242 


00 00 


000000 


LSH 


453 


00 00 


000000 


SETCAB 


246 


00 00 


000000 


LSHC 


451 


00 00 


000000 


SETCAI 


257 


00 00 


000000 


**MAP 


452 


00 00 


000000 


SETCAM 


200 


00 00 


000000 


MOVE 


460 


00 00 


000000 


SETCM 


201 


00 00 


000000 


MOVE I 


463 


00 00 


000000 


SETCMB 


202 


00 00 


000000 


MOVEM 


461 


00 00 


000000 


SETCMI 


203 


00 00 


000000 


MOVES 


462 


00 00 


000000 


SETCMM 


214 


00 00 


000000 


MOVM 


414 


00 00 


000000 


SETM 


215 


00 00 


000000 


MOVMI 


417 


00 00 


000000 


SETMB 


216 


00 00 


000000 


MOVMM 


415 


00 00 


000000 


SETMI 


217 


00 00 


000000 


MOVMS 


416 


00 00 


000000 


SETMM 


210 


00 00 


000000 


MOVN 


474 


00 00 


000000 


SETO 


211 


00 00 


000000 


MOVNI 


477 


00 00 


000000 


SETOB 


212 


00 00 


000000 


MOVNM 


475 


00 00 


000000 


SETOI 


213 


00 00 


000000 


MOVNS 


476 


00 00 


000000 


SETOM 


204 


00 00 


000000 


MOVS 


400 


00 00 


000000 


SETZ 


205 


00 00 


000000 


MOVSI 


403 


00 00 


000000 


SETZB 


206 


00 00 


000000 


MOVSM 


401 


00 00 


000000 


SETZI 


207 


00 00 


000000 


MOVSS 


402 


00 00 


000000 


SETZM 


224 


00 00 


000000 


MUL 


330 


00 00 


000000 


SKIP 


227 


00 00 


000000 


MULB 


334 


00 00 


000000 


SKIPA 


225 


00 00 


000000 


MULI 


332 


00 00 


000000 


SKIPE 


226 


00 00 


000000 


MULM 


337 


00 00 


000000 


SKIPG 


434 


00 00 


000000 


OR 


335 


00 00 


000000 


SKIPGE 


437 


00 00 


000000 


ORB 


331 


00 00 


000000 


SKIPL 


454 


00 00 


000000 


ORCA 


333 


00 00 


000000 


SKIPLE 


457 


00 00 


000000 


ORCAB 


336 


00 00 


000000 


SKIPN 


455 


00 00 


000000 


ORCA I 


360 


00 00 


000000 


SOJ 


456 


00 00 


000000 


ORCAM 


364 


00 00 


000000 


SOJA 


470 


00 00 


000000 


ORCB 


362 


00 00 


000000 


SOJE 


473 


00 00 


000000 


ORCBB 


367 


00 00 


000000 


SOJG 
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365 


00 00 


000000 


SOJGE 


667 


00 00 


000000 


TLON 


361 


00 00 


000000 


SOJL 


621 


00 00 


000000 


TLZ 


363 


00 00 


000000 


SOJLE 


625 


00 00 


000000 


TLZA 


366 


00 00 


000000 


SOJN 


623 


00 00 


000000 


TLZE 


370 


00 00 


000000 


SOS 


627 


00 00 


000000 


TLZN 


374 


00 00 


000000 


SOSA 


640 


00 00 


000000 


TRC 


372 


00 00 


000000 


SOSE 


644 


00 00 


000000 


TRCA 


377 


00 00 


000000 


SOSG 


642 


00 00 


000000 


TRCE 


375 


00 00 


000000 


SOSGE 


646 


00 00 


000000 


TRCN 


371 


00 00 


000000 


SOSL 


600 


00 00 


000000 


TRN 


373 


00 00 


000000 


SOSLE 


604 


00 00 


000000 


TRNA 


376 


00 00 


000000 


SOSN 


602 


00 00 


000000 


TRNE 


274 


00 00 


000000 


SUB 


606 


00 00 


000000 


TRNN 


277 


00 00 


000000 


SUBB 


660 


00 00 


000000 


TRO 


275 


00 00 


000000 


SUBI 


664 


00 00 


000000 


TROA 


276 


00 00 


000000 


SUBM 


662 


00 00 


000000 


TROE 


650 


00 00 


000000 


TDC 


666 


00 00 


000000 


TRON 


654 


00 00 


000000 


TDCA 


620 


00 00 


000000 


TRZ 


652 


00 00 


000000 


TDCE 


624 


00 00 


000000 


TRZA 


656 


00 00 


000000 


TDCN- 


622 


00 00 


000000 


TRZE 


610 


00 00 


000000 


TDN 


626 


00 00 


000000 


TRZN 


614 


00 00 


000000 


TDNA 


651 


00 00 


000000 


TSC 


612 


00 00 


000000 


TDNE 


655 


00 00 


000000 


TSCA 


616 


00 00 


000000 


TDNN 


653 


00 00 


000000 


TSCE 


670 


00 00 


000000 


TDO 


657 


00 00 


000000 


TSCN 


674 


00 00 


000000 


TDOA 


611 


00 00 


000000 


TSN 


672 


00 00 


000000 


TDOE 


615 


00 00 


000000 


TSNA 


676 


00 00 


000000 


TDON 


613 


00 00 


000000 


TSNE 


630 


00 00 


000000 


TDZ 


617 


00 00 


000000 


TSNN 


634 


00 00 


000000 


TDZA 


671 


00 00 


000000 


TSO 


632 


00 00 


000000 


TDZE 


675 


00 00 


000000 


TSOA 


636 


00 00 


000000 


TDZN 


673 


00 00 


000000 


TSOE 


641 


00 00 


000000 


TLC 


677 


00 00 


000000 


TSON 


645 


00 00 


000000 


TLCA 


631 


00 00 


000000 


TSZ 


643 


00 00 


000000 


TLCE 


635 


00 00 


000000 


TSZA 


647 


00 00 


000000 


TLCN 


633 


00 00 


000000 


TSZE 


601 


00 00 


000000 


TLN 


637 


00 00 


000000 


TSZN 


605 


00 00 


000000 


TLNA 


130 


00 00 


000000 


UFA 


603 


00 00 


000000 


TLNE 


256 


00 00 


000000 


XCT 


607 


00 00 


000000 


TLNN 


430 


00 00 


000000 


XOR 


661 


00 00 


000000 


TLO 


433 


00 00 


000000 


XORB 


665 


00 00 


000000 


TLOA 


431 


00 00 


000000 


XORI 


663 


00 00 


000000 


TLOE 


432 


00 00 


000000 


XORM 
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C.2 I/O INSTRUCTION AND DEVICE CODE MNEMONICS 

Table C-2 shows MACRO'S I/O instruction mnemonics and the code each 
assembles. Note that I/O machine instructions are executable only in 
executive mode. 



Table C-2 
I/O Instruction Mnemonics 



7 000 00 00 000000 


BLKI 


7 000 30 00 000000 


CONSZ 


7 000 10 00 000000 


BLKO 


7 000 04 00 000000 


DATA I 


7 000 24 00 000000 


CON I 


7 000 14 00 000000 


DATAO 


7 000 20 00 000000 


CONO 


7 000 04 00 000000 


RSW 


7 000 34 00 000000 


CONSO 







Table C-3 shows MACRO'S I/O device code mnemonics. Each is assembled 
with the I/O instruction mnemonic DATAI so that the value of the 
device code will be in its proper field. In the first table entry, 
for example, the assembled code is: 

7 024 04 00 000000 

where the 7 and 04 are generated by the DATAI instruction, and the 024 
by the ADC device code mnemonic. . 



NOTE 

MACRO leaves these device code mnemonics 
as undefined symbols during Pass 1. At 
the end of Pass 1, the mnemonics are 
found in MACRO'S tables only if one or 
more I/O instructions have been found. 

Therefore, if a device code mnemonic is 
not assembled in Pass 1, or if no I/O 
instruction mnemonics were found, MACRO 
will not have defined the device code 
mnemonic . 
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7 


024 


04 





00 


000000 


DATA I 


ADC, 


7 


030 


04 





00 


000000 


DATA I 


ADC 2, 


7 


000 


04 





00 


000000 


DATA I 


APR, 


7 


014 


04 





00 


oooooo 


DATA I 


CCI, 


7 


110 


04 





00 


000000 


DATA I 


CDP, 


7 


114 


04 





00 


oooooo 


DATA I 


CDR, 


7 


070 


04 





00 


oooooo 


DATA I 


CLK, 


7 


074 


04 





00 


oooooo 


DATA I 


CLK2 f 


7 


000 


04 





00 


oooooo 


DATA I 


CPA, 


7 


150 


04 





00 


oooooo 


DATA I 


CR, 


7 


154 


04 





00 


oooooo 


DATA I 


CR2, 


7 


200 


04 





00 


oooooo 


DATA I 


DC, 


7 


204 


04 





00 


oooooo 


DATA I 


DC2, 


7 


300 


04 





00 


oooooo 


DATA I 


DCSA, 


7 


304 


04 





00 


oooooo 


DATA I 


DCSB, 


7 


270 


04 





00 


oooooo 


DATA I 


DDC, 


7 


274 


04 





00 


oooooo 


DATA I 


DDC2, 


7 


270 


04 





00 


oooooo 


DATA I 


DF, 


7 


130 


04 





00 


oooooo 


DATA I 


DIS, 


7 


134 


04 





00 


oooooo 


DATA I 


DIS2, 


7 


060 


04 





00 


oooooo 


DATA I 


DLB, 


7 


160 


04 





00 


oooooo 


DATA I 


DLB2, 


7 


064 


04 





00 


oooooo 


DATA I 


DLC, 


7 


164 


04 





00 


oooooo 


DATA I 


DLC2, 


7 


240 


04 





00 


oooooo 


DATA I 


DLS, 


7 


244 


04 





00 


oooooo 


DATA I 


DLS2, 


7 


250 


04 





00 


oooooo 


DATA I 


DPC, 


7 


254 


04 





00 


oooooo 


DATA I 


DPC2, 


7 


260 


04 





00 


oooooo 


DATA I 


DPC3, 


7 


264 


04 





00 


oooooo 


DATA I 


DPC4, 


7 


464 


04 





00 


oooooo 


DATA I 


DSI, 


7 


474 


04 





00 


oooooo 


DATA I 


DSI2, 


7 


170 


04 





00 


oooooo 


DATA I 


DSK, 


7 


174 


04 





00 


oooooo 


DATA I 


DSK2, 


7 


460 


04 





00 


oooooo 


DATA I 


DSS, 


7 


470 


04 





00 


oooooo 


DATA I 


DSS2, 


7 


320 


04 





00 


oooooo 


DATA I 


DTC, 


7 


330 


04 





00 


oooooo 


DATA I 


DTC2, 


7 


324 


04 





00 


oooooo 


DATA I 


DTS, 


7 


334 


04 





00 


oooooo 


DATA I 


DTS2, 


7 


124 


04 





00 


oooooo 


DATA I 


LPT, 


7 


234 


04 





00 


oooooo 


DATA I 


LPT2, 


7 


260 


04 





00 


oooooo 


DATA I 


MDF, 


7 


264 


04 





00 


oooooo 


DATA I 


MDF2, 


7 


220 


04 





00 


oooooo 


DATA I 


MTC, 


7 


230 


04 





00 


oooooo 


DATA I 


MTM, 


7 


224 


04 





00 


oooooo 


DATA I 


MTS, 


7 


010 


04 





00 


oooooo 


DATA I 


PAG, 
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Table C-3 (Cont.) 
I/O Device Code Mnemonics 



7 


004 


04 





00 


000000 


DATA I 


PI, 


7 


140 


04 





00 


000000 


DATA I 


PLT, 


7 


144 


04 





00 


000000 


DATA I 


PLT2, 


7 


100 


04 





00 


000000 


DATA I 


PTP, 


7 


104 


04 





00 


000000 


DATA I 


PTR, 


7 


340 


04 





00 


000000 


DATA I 


TMC, 


7 


350 


04 





00 


000000 


DATA I 


TMC2, 


7 


344 


04 





00 


000000 


DATA I 


TMS, 


7 


354 


04 





00 


000000 


DATA I 


TMS2, 


7 


120 


04 





00 


000000 


DATA I 


TTY, 


7 


210 


04 





00 


000000 


DATA I 


UTC, 


7 


214 


04 





00 


000000 


DATA I 


UTS, 
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C.3 KL10 EXTEND INSTRUCTION MNEMONICS 

Table C-4 shows the KL10 EXTEND instruction mnemonics and the code 
assembled by each. All of these mnemonics are defined only if MACRO 
is assembled with the KL10 switch on. 



See the Supplement to the Hardware Reference Manual for 
of these EXTEND instructions. 



discussion 



Table C-4 
KL10 EXTEND Instruction Mnemonics 



002 00 00 000000 


*CMPSE 


010 00 00 000000 


*CVTDBO 


007 00 00 000000 


*CMPSG 


011 00 00 000000 


*CVTDBT 


005 00 00 000000 


*CMPSGE 


004 00 00 000000 


*EDIT 


001 00 00 000000 


*CMPSL 


016 00 00 000000 


*MOVSLJ 


003 00 00 000000 


*CMPSLE 


014 00 00 000000 


*MOVSO 


006 00 00 000000 


*CMPSN 


017 00 00 000000 


*MOVSRJ 


012 00 00 000000 


*CVTBDO 


015 00 00 000000 


*MOVST 


013 00 00 000000 


*CVTBDT 


020 00 00 000000 


*XBLT 
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C.4 JRST AND JFCL MNEMONICS 

Table C-5 shows mnemonics that assemble both operator and accumulator 
fields in the machine instruction. The left side of the table shows 
the mnemonics and the code they generate; the right side shows JRST 
and JFCL mnemonics with accumulators generating the equivalent code. 



Table C-5 
JRST and JFCL Mnemonics 



Code and 


Mnemonic 




Equivalent Code and 


Mnemonic 


254 


04 





00 


000000 


HALT 


254 


04 





00 


000000 


JRST 4, 


255 


06 





00 


000000 


JCRY 


255 


06 





00 


000000 


JFCL 6, 


255 


04 





00 


000000 


JCRY0 


255 


04 





00 


000000 


JFCL 4, 


255 


02 





00 


000000 


JCRY1 


255 


02 





00 


000000 


JFCL 2, 


254 


12 





00 


000000 


JEN 


254 


12 





00 


000000 


JRST 12, 


255 


01 





00 


000000 


JFOV 


255 


01 





00 


000000 


JFCL 1, 


255 


10 





00 


000000 


JOV 


255 


10 





00 


000000 


JFCL 10, 


254 


02 





00 


000000 


JRSTF 


254 


02 





00 


000000 


JRST 2, 


254 


01 





00 


000000 


PORTAL 


254 


01 





00 


000000 


JRST 1, 


254 


06 





00 


000000 


*XJEN 


254 


06 





00 


000000 


JRST 6, 


254 


05 





00 


000000 


*XJRSTF 


254 


05 





00 


000000 


JRST 5, 


254 


07 





00 


000000 


*XPCW 


254 


07 





00 


000000 


JRST 7, 


254 


14 





00 


000000 


*XSFM 


254 


14 





00 


000000 


JRST 14, 
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C.5 DECsystem-10 MONITOR CALL MNEMONICS 

Tables C-6 through C-9 show MACRO'S DECsystem-10 monitor call 
mnemonics and related mnemonics. 

Table C-6 shows DECsystem-10 monitor calls and their assembled code. 

Tables C-7 through C-9 show DECsystem-10 CALLI , TTCALL, and MTAPE 
mnemonics and their assembled code. These mnemonics are defined only 
if MACRO'S UUOSYM switch is on when MACRO is assembled. 



Table C-6 
DECsystem-10 Monitor Calls 



040 00 00 


000000 


CALL 


067 


00 00 


oooooo 


OUTPUT 


047 00 00 


000000 


CALLI 


052 


00 00 


oooooo 


*RDCLK 


070 00 00 


000000 


CLOSE 


071 


00 00 


oooooo 


RELEAS 


077 00 00 


000000 


ENTER 


055 


00 00 


oooooo 


RENAME 


062 00 00 


000000 


GETSTS 


060 


00 00 


oooooo 


SETSTS 


056 00 00 


000000 


IN 


061 


00 00 


oooooo 


. STATO 


064 00 00 


000000 


INBUF 


062 


00 00 


oooooo 


STATUS 


041 00 00 


000000 


INIT 


063 


00 00 


oooooo 


STATZ 


066 00 00 


000000 


INPUT 


051 


00 00 


oooooo 


TTCALL 


076 00 00 


oooooo 


LOOKUP 


073 


00 00 


oooooo 


UGETF 


072 00 00 


000000 


MTAPE 


100 


00 00 


oooooo 


UJEN 


050 00 00 


oooooo 


OPEN 


074 


00 00 


oooooo 


USETI 


057 00 00 


oooooo 


OUT 


075 


00 00 


oooooo 


USETO 


065 00 00 


oooooo 


OUTBUF 
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Table C-7 
DECsystem-10 CALLI Mnemonics 



047 


00 00 


000161 


ALLOC. 


047 


00 00 


000144 


IPCFQ. 


047 


00 00 


000016 


APRENB 


047 


00 00 


000142 


IPCFR. 


047 


00 00 


000104 


ATTACH 


047 


00 00 


000143 


IPCFS. 


047 


00 00 


000125 


CAL11. 


047 


00 00 


000113 


JBSET. 


047 


00 00 


000156 


CAL78. 


047 


00 00 


000103 


JOBPEK 


047 


00 00 


000074 


CHGPPN 


047 


00 00 


000047 


JOBSTR 


047 


00 00 


000100 


CHKACC 


047 


00 00 


000061 


JOBSTS 


047 


00 00 


000134 


CLRST. 


047 


00 00 


777777 


LIGHTS 


047 


00 00 


000130 


CNECT. 


047 


00 00 


000062 


LOCATE 


047 


00 00 


000147 


COMPT. 


047 


00 00 


000060 


LOCK 


047 


00 00 


000011 


CORE 


047 


00 00 


000015 


LOGIN 


047 


00 00 


000065 


CTLJOB 


047 


00 00 


000017 


LOGOUT 


047 


00 00 


000105 


DAEFIN 


047 


00 00 


000111 


METER. 


047 


00 00 


000102 


DAEMON 


047 


00 00 


000023 


MSTIME 


047 


00 00 


000014 


DATE 


047 


00 00 


000126 


MTAID. 


047 


00 00 


000005 


DDTGT 


047 


00 00 


000112 


MTCHR. 


047 


00 00 


000001 


DDTIN 


047 


00 00 


000131 


MVHDR. 


047 


00 00 


000003 


DDTOUT 


047 


00 00 


000157 


NODE. 


047 


00 00 


000007 


DDTRL 


047 


00 00 


000077 


OTHUSR 


047 


00 00 


000137 


DEBRK. 


047 


00 00 


000145 


PAGE. 


047 


00 00 


000152 


DEQ. 


047 


00 00 


000110 


PATH. 


047 


00 00 


000004 


DEVCHR 


047 


00 00 


000033 


PEEK 


047 


00 00 


000076 


DEVGEN 


047 


00 00 


000162 


PERF. 


047 


00 00 


000107 


DEVLNM 


047 


00 00 


000135 


PIINI. 


047 


00 00 


000064 


DEVNAM 


047 


00 00 


000141 


PIRST. 


047 


00 00 


000055 


DEVPPN 


047 


00 00 


000140 


PISAV. 


047 


00 00 


000101 


DEVSIZ 


047 


00 00 


000136 


PISYS. 


047 


00 00 


000054 


DEVSTS 


047 


00 00 


000030 


PJOB 


047 


00 00 


000053 


DEVTYP 


047 


00 00 


000114 


POKE. 


047 


00 00 


000121 


DISK. 


047 


00 00 


000021 


REASSI 


047 


00 00 


000045 


DSKCHR 


047 


00 00 


000037 


REMAP 


047 


00 00 


000122 


DVRST. 


047 


00 00 


000117 


RESDV. 


047 


00 00 


000123 


DVURS. 


047 


00 00 


000000 


RESET 


047 


00 00 


000151 


ENQ. 


047 


00 00 


000057 


RTTRP 


047 


00 00 


000153 


ENQC. 


047 


00 00 


000035 


RUN 


047 


00 00 


000132 


ERLST. 


047 


00 00 


000027 


RUNTIM 


047 


00 00 


000160 


ERRPT. 


047 


00 00 


000150 


SCHED. 


047 


00 00 


000012 


EXIT 


047 


00 00 


000056 


SEEK 


047 


00 00 


000155 


FILOP. 


047 


00 00 


000133 


SENSE. 


047 


00 00 


000106 


FRCUUO 


047 


00 00 


000002 


SETDDT 


047 


00 00 


000052 


FRECHN 


047 


00 00 


000043 


SETNAM 


047 


00 00 


000006 


GETCHR 


047 


00 00 


000032 


SETPOV 


047 


00 00 


000034 


GETLIN 


047 


00 00 


000075 


SETUUO 


047 


00 00 


000024 


GETPPN 


047 


00 00 


000036 


SETUWP 


047 


00 00 


000040 


GETSEG 


047 


00 00 


000031 


SLEEP 


047 


00 00 


000041 


GETTAB 


047 


00 00 


000042 


SPY 


047 


00 00 


000066 


GOBSTR 


047 


00 00 


000050 


STRUUO 


047 


00 00 


000072 


HIBER 


047 


00 00 


000146 


SUSET. 


047 


00 00 


000071 


HPQ 


047 


00 00 


000020 


SWITCH 


047 


00 00 


000127 


IONDX. 


047 


00 00 


000051 


SYSPHY 



(Continued on Next Page) 
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Table C-7 (Cont.) 
DECsystem-10 CALLI Mnemonics 



047 00 00 000046 


SYSSTR 


047 00 00 000025 


TRPSET 


047 00 00 000154 


TAPOP. 


047 00 00 000120 


UNLOK. 


047 00 00 000022 


TIMER 


047 00 00 000013 


UTPCLR 


047 00 00 000044 


TMPCOR 


047 00 00 000010 


WAIT 


047 00 00 000115 


TRMNO. 


047 00 00 000073 


WAKE 


047 00 00 000116 


TRMOP. 


047 00 00 000063 


WHERE 


047 00 00 000026 


TRPJEN 


047 00 00 000124 


XTTSK. 



Table C-8 
DECsystem-10 TTCALL Mnemonics 



051 11 00 000000 


CLRBFI 


051 15 00 000000 


IONEOU 


051 12 00 000000 


CLRBFO 


051 01 00 000000 


OUTCHR 


051 06 00 000000 


GETLCH 


051 03 00 000000 


OUTSTR 


051 02 00 000000 


INCHRS 


051 10 00 000000 


RESCAN 


051 00 00 000000 


INCHRW 


051 07 00 000000 


SETLCH 


051 05 00 000000 


INCHSL 


051 13 00 000000 


SKPINC 


051 04 00 000000 


INCHWL 


051 14 00 000000 


SKPINL 



Table C-9 
DECsystem-10 MTAPE Mnemonics 



072 00 00 000013 


MTBLK. 


072 00 00 000101 


MTIND. 


072 00 00 000017 


MTBSF. 


072 00 00 000001 


MTREW. 


072 00 00 000007 


MTBSR. 


072 00 00 000016 


MTSKF. 


072 00 00 000100 


MTDEC. 


072 00 00 000006 


MTSKR. 


072 00 00 000003 


MTEOF. 


072 00 00 000011 


MTUNL. 


072 00 00 000010 


MTEOT. 


072 00 00 000000 


MTWAT . 
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C.6 F40 UUO MNEMONICS 

Table C-10 shows mnemonics that are defined only if MACRO is assembled 
with the F40 switch on. These mnemonics generate UUOs, which are 
handled properly if the program is running under control of the FORSE 
object-time system. 



Table C-10 
F40 UUO Mnemonics 



020 00 00 000000 ***DATA. 


017 00 00 000000 ***OUT. 


021 00 00 000000 ***FIN. 


027 00 00 000000 ***OUTF. 


016 00 00 000000 ***IN. 


015 00 00 000000 ***RESET. 


026 00 00 000000 ***INF. 


022 00 00 000000 ***RTB. 


024 00 00 000000 ***MTOP. 


025 00 00 000000 ***SLIST. 


031 00 00 000000 ***NLI. 


023 00 00 000000 ***WTB. 


032 00 00 000000 ***NLO. 
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PROGRAM EXAMPLES 



The following pages contain examples of MACRO programs. Each program 
has been assembled with the /C (CREF) switch on; this produces a .CRF 
file for the program listing (instead of the usual .LST file). The /O 
switch has been used with the CREF program to produce a .LST file that 
includes all operators in an operator symbol table. 



D-l 



MACROS MACRO 253(1017) 16: 12 2-Mai 78 Fade 1 

EXAMPI... MAC 2™Mar~78 15:03 Example One 



O 
to 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 

NO ERRORS DETECTED 

PROGRAM BREAK IS 000000 
CPU TIME USED 00 : 00, 411 

10P CORE USED 



SLJBTTL Example One 
UNIVERSAL MACROS 

JThis UNIVERSAL prod ram contains the macro QUIT* which uses 

* conditional assembly to Generate a program exit monitor 

* call. If the T0PS10 switch is on when OUIT is called (or if 

* it is undefined)!- QUIT Generates "EXIT"* if the switch 

* is off* QUIT generates "HALTF". 



DEFINE QUIT < 

IFNDEF T0PS10* 
TOPS 10- - 1 

IFE T0PS10* < 
HALTF 

I FN T0PS10*< 
EXIT 



PRGEND 



» JDefault is T0PS10 
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EXAMPL MAC 2-Mar -78 15:03 Example Two 



a 
I 

U) 



23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 



SUBTTL Example Two 

TITLE Second Example of MACRO Program 

This program contains the macros CLEAR* CONCAT* and EXPAND. 
These can he used to append arbitrary text into a buffer* 
and to recall the text later. Two seauences of calls 
to the macros show possible uses. 

The following points are of interest: 

1. The buffer is cleared by calling CLEAR. Text is added 
(on the right side of the buffer) by calling CONCAT. 
EXPAND* when used in a context allowed for macro calls* 
expands the contents of the buffer into source code. 

2. A call to CLEAR defines the text buffer* EXPAND* to 
contain no text. It also defines the macro CONCAT in 
such a way that the first call to CONCAT redefines 
EXPAND to contain the first piece of text* and CONCAT 
redefines itself so that further calls to CONCAT will 
call the internal macro C0N1 . Following the second 
call to CONCAT* each further call merely appends new 
text to the old. 

3. A key feature of EXPAND is that it contains no carriage 
returns. If it did* then each concatenation of new 
text would 3lso insert a carriage return into the text. 

4. The first use of these macros shows that EXPAND can be 
placed in contexts where more than one argument will 
result (as in the BYTE pseudo-op). Note that because 
angle brackets are used internally (inside the macros) 
to delimit text* all concatenated text must contain 
matched angle brackets. 

5. Note that carriage returns* if desired* can be easily 
concatenated to the buffer* this is done in the second 
use of the macros. 
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D 
I 

4^ 



62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 



000000' 010 101 006 00000 



define clear < 

define concat (ftxt) < 
define concat (text) 
coni <text>»<ftxt; 

define expand <ftxt> 

define expand <> 



DEFINE CON1 (NTXT,0TXT) < 
DEFINE CONCAT (TEXT) < 

C0N1 <TEXT> f <0TXT ' NTXT> 

DEFINE EXPAND <OTXT'NTXT> 



SALL 

CLEAR 

CONCAT <10> 

CONCAT <»> 

CONCAT <"A"> 

CONCAT < t «- 1 r f 6> & 1 77>: 

LALL 

BYTE (7)EXPANEri0r , A*»- 

SALL 
CLEAR 

CONCAT <DEF> 

CONCAT <INE FOO (> 

CONCAT <N)> 

CONCAT «2*N> 

DEFINE> 

CONCAT < BAR (N) <3*N> 



o 
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> 
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105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 



000001' 000000 000004 

000002' 000000 000006 

000003' 000000 000006 

000004' 000000 000011 



LALL 

EXPAND~DEFINE F00 <N) 

DEFINE BAR (N) <3*N> 



F00 2-2*2' 
F00 3"2*3' 
BAR 2~3*2' 
BAR 3~3*3' 



?*N.: 



PRGENEi 



a 
I 
<J1 



NO ERRORS DETECTED 

PROGRAM BREAK IS 000005 
CPU TIME USED 00 1 00. 180 

10P CORE USED 
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a 

I 



118 
1 1 9 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
13.1 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
.1.57 



SUBTTL Example Three 

TITLE Third Example of MACRO Proa ram 

This program uses the macros NUMLST and X to generate parallel 
tables. 

This example generates a table that contains keywords suitable 
for comparison to user input J the second table generated 
contains addresses of routines that handle those keywords; 
the third table contains useful values. 

The keyword table is arranged alphabetically to speed searching; 
the other two tables correspond entry -for -entry to the 
keyword table. 

Key features of this program include: 

1. Changing the size of the tables is easy. For example* 
if a new entry* FIFTH* is needed* adding the word and 
a dummy label to the definition of NUMLST will update 
both tables* no separate update is reouired. 

2. The macro NUMLST calls the macro X. Before each call 
to NUMLST* X is redefined so that the proper kind of 
table is built. Note that a definition of X need not 
use both arguments in the macrobody. (However* X should 
define both arguments.) 

3. The second definition of X uses concatenation to build 
mnemonic labels for the table LBLTBL. 

4* The program uses the macro QUIT so that it can be used 

for either TOPS- 10 or TOPS-20. The SEARCH MACROS statement 
makes the definition of QUIT available* since the default 
for QUIT is T0PS-10* the program will run on T0PS-10 if 
either it defines T0PS10=-1 or does not define T0PS10* 
the program will run on T0PS-20 only if it defines 
TOPS 10=0. 
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sample o 


f MACRO 


Prod ram 


EXAMPL. 


MAC . 


2-Mar- 


78 is:o; 
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170 








171 








172 


000000 ' 






173 


000000' 


465162 


636400 


174 


000001' 


465765 


626450 


175 


000002' 


634543 


575644 


176 


000003 ' 


645051 


624400 


177 






000004 


178 








179 








180 








181 


000004' 






182 


000004' 


000000 


000014 


183 


000005' 


000000 


000017 


184 


000006' 


000000 


000015 


185 


000007' 


000000 


000016 


186 








187 








188 








189 


000010' 






190 


000010' 


000000 


000001 


191 


000011' 


000000 


000004 


192 


000012' 


000000 


000002 


193 


000013' 


000000 


000003 


194 








195 
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SEARCH MACROS 
.DIRECTIVE SFCOND 

DEFINE NUMLST < 
X (FIRST, 1) 
X (FOURTH, 4) 
X (SECOND, 2) 
X (THIRD, 3) 



DEFINE X (TEXT, JUNK) <EXP SIXBIT /TEXT/!: 

NAMTBL: NUMLST" 

X (FIRST, 1)"EXP SIXBIT /FIRST/" 
X (FOURTH, 4) "EXP SIXBIT /FOURTH/" 
X (SECOND, 2) "EXP SIXBIT /SECOND/" 
X (THIRD, 3) "EXP SIXBIT /THIRD/" 

TBLLEN==. -NAMTBL 

DEFINE X (JUNK,LABL) <$'LABL> 

LBLTBL.: NUMLST" 

X (FIRST, 1)"$1" 
X (FOURTH, 4)"*4" 
X ( SECOND, 2) "$2" 
X (THIRD,3)"$3" 

DEFINE X (JUNK,YALU) <DEC YALU> 

VALTBL: NUMLST" 

X (FIRST, 1) "DEC 1" 
X (FOURTH, 4) "DEC 4" 
X (SECOND, 2) "DEC 2" 
X (THIRD, 3) "DEC 3" 
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196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 



000014' 

000014' 047 00 00 000012 

000015' 

000015' 047 00 00 000012 

000016' 

000016' 047 00 00 000012 

000017' 

000017' 047 00 00 000012 



XALL 




$i: 


QUIT 




EXIT 


$2: 


QUIT 




EXIT 


$3: 


QUIT 




EXIT 


$4: 


QUIT 




EXIT 


PRGEND 





NO ERRORS DETECTED 
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PROGRAM BREAK IS 000020 
CPU TIME USED 00 I 00* 142 

10P CORE USED 
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EXIT 


047000 


000012 




LBLTBL 




000004' 




NAMTBL 




000000' 




TBLLEN 




000004 


spd 


T0PS10 


777777 


777777 


spd 


VALTBL 




000010' 




$1 




000014' 




*2 




000015' 




*3 




000016' 




$4 




000017' 
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209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
':> ':> -> 

223 
224 
225 
226 
227 
228 
229 
230 
23.1 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 



SUBTTL Example Four 

TITLE Fourth Example of MACRO Program 

This program contains a complex and useful macro* COMMON. 
The macro allows declaration of variable names for a 
FORTRAN-con.patible COMMON block. Note that the pseudo-op 
.COMMON allows declaration of a COMMON block * but not of 
variable names within the block. 

The COMMON macro uses two arguments J 

1. The name of the COMMON block. 

2. An IRP style list of the variable names for the block. 
The list can contain either variable names only (with 
an assumed length of one word for each variable) * or 
can contain an angle -bracketed pair giving the name and 
the length in decimal. 

Key features of the program include J 

1. Lengths for variables are given in decimal numbers* 
so that the definitions look much like those in the 
FORTRAN language. This is accomplished by storing 
the current radix in a created symbol* and restoring 
it at the end of the macro. 

2. The macro uses the technioue of IRF'ing more than once 
on the IRP list. The first IRP counts the length of 
the entire COMMON block* so that the .COMMON pseudo-op 
can be used* the second IRP declares variable names 
for each entry in the block. 

3. The pseudo-ops .XCREF and PURGE are used often 

in the macro* this is to remove references to created 
symbols from the CREF listing and the symbol table. 

4. Created symbols are used in the macro for symbols that 
are used only within the macro itself. This minimises 
the chance that other definitions will conflict with 
these symbols. 

5. Once the COMMON macro has been called* symbols in the 
COMMON block may be used much as any other symbols* 
this is shown in the IFIX and ZERO routines. 
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256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 



DEFINE COMMON (COM, VARS,%RADf%LEN, %VAL ,%C0M»%PAS ) < 
. XCREF ZRAD r %LEN r ZVAL , ZCOM » XPAS 

rfTeuiP macro to strip one pair of angle brackets from 
it a macro argument and pass it to another macro 

DEFINE %PAS <A,B) <A B> 

i i Temp macro to compute length of COMMON 

DEFINE %C0M <VAR,LEN<1>) <%LEN==XLEN+LEN> 



%RAD=^10 

RADIX 10 

%LEN^0 

IRP VARS<ZPAS %C0M>VARS> 

♦COMMON C0MCZLEN3 

DEFINE %C0M < UAR,LEN<1>> 
VAR^ZVAL 
%VAL==%VAL+LEN 



%LEN==0 

%VAL. ==C0M 

IRP YARS<%PAS XC0M»yARS:: 

RADIX ZRAD 



JSave current radix* use 10 
i so defs read like FORTRAN 
»Set to count length of COMMON 
rGet lens=th of this COMMON 
f Allocate the whole COMMON 

i Set up another temp macro 
»Define COMMON block entry 
i Increment to next entry 



5 ^Reinitialize length 
ii Start to define entries in blo^ 
JJDefine next COMMON entry 
{('Restore current radix 
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290 
291 
'^92 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 



2-M3T-78 15103 



000000' 122 01 00 000000* 
000001' 202 01 00 000000* 
000002' 263 17 00 000000 



000003' 200 01 00 000007' 

000004' 402 00 00 000000* 

000005' 251 01 00 000000* 

000006' 263 17 00 000000 

000007' 

000007' 000000* 000000* 



NO ERRORS DETECTED 

PROGRAM BREAK IS 000010 
CPU TIME USED 00 1 00. 228 



Example Four 

i ♦ ♦ ♦ 

i INTEGER SNGLE, ARRAY* MULTI 

i REAL REAL 

t DOUBLE PRECISION DOUBLE 

i COMMON /AREA/SNGLE»REAL»D0UBLEfARRAY(10)»MULTI(5»10) 

COMMON AREA , CSNGLE » REAL » <DOUBLE 1 2> t < ARRAY » 10> > <MULTI , 5*10»" 

J Sample routine to do SNGLE=IFIX(REAL > 

IFIX: FIX If REAL 

MOVEM IrSNGLE 
POP J 17 t 

f Sample routine to set all elements in ARRAY to 

zero: move i^cxwD array* array+i:i 

SETZM ARRAY 
BLT 1,ARRAY+~D9 
POP J 17 r 

LIT 



END 
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AREA 


000001' 


ext 


ARRAY 


000000000000* 


POl 


DOUBLE 


000000000000* 


POl 


IFIX 


000000' 




MULTI 


000000000000* 


POl 


REAL 


000000000000* 


POl 


SNGLE 


000000* 




ZERO 


000003' 
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AREA 


298# 


298 


ARRAY 


298* 


307 


DOUBLE 


298* 




IFIX 


301* 




LBLTBL 


181* 




MULT I 


298* 




NAMTBL 


172* 


177 


REAL 


298* 


301 


SNGLE 


298* 


302 


TBLLEN 


177* 




TOPS 10 


200 


202 


VALTBL 


189* 




ZERO 


307* 




*1 


182 


199* 


*2 


184 


201* 


$3 


185 


203* 


$4 


183 


205* 



308 309 



204 206 
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BAR 


109* 


114 


115 




CLEAR 


64* 


83 


94 




COMMON 


2581= 


297 






CON1 


74* 


86 


87 


88 


CONCAT 


83* 


85 


85* 


86 




98 


98* 


99 


100* 


EXIT 


200 


202 


204 


206 


EXPAND 


83* 


85* 


86* 


87* 


FOO 


108* 


112 


113 




NUMLST 


163* 


172 


181 


189 


QUIT 


10* 


199 


201 


203 


X 


170* 
193 


173 


174 


175 


. .0004 


298 


298* 






..0005 


298 









97 98 100 102 

86* 87 87* 88 88* 94* 96 96* 97 97* 

101 102* 

88* 91 94* 96* 97* 98* 100* 102* 108 

205 

176 179* 182 183 184 185 187* 190 191 192 
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BLT 


309 




BYTE 


91 




DEC 


190 


191 


DEFINE 


10 


64 




108 


109 


END 


315 




EXP 


173 


174 


FIX 


301 




IF2 


298 




IFE 


200 


202 


IFN 


200 


202 


IFNDEF 


200 


202 


IRP 


298 




LALL 


90 


107 


LIT 


312 




MOVE 


307 




MOVEM 


302 




POPJ 


303 


310 


PRGEND 


21 


117 


PURGE 


298 




RADIX 


298 




SALL 


81 


93 


SEARCH 


160 




SETZM 


308 




SIXBIT 


173 


174 


SUBTTL 


1 


i*? 


TITLE 


23 


119 


UN IYER 


*j 




XALL 


198 




XWD 


307 




.COMMO 


298 




.DIREC 


161 





192 193 

74 83 85 86 87 88 94 96 97 98 100 10; 

163 170 179 187 258 298 

175 176 



204 


206 


204 


206 


204 


206 



208 



175 


176 


118 


209 


210 





APPENDIX E 
PSEUDO-OPS FOR PROGRAM COMPATIBILITY 



The pseudo-ops in this appendix are included only for compatibility of 
old programs to be assembled using MACRO Version 53. 
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HISEG 



FORMAT 



HISEG address 



address = program high-segment origin address. Must be 
equal to or greater than 400000 and must be a 
multiple of 1000. 



FUNCTION 



Directs the loader to load the current program into the 
high segment if the program has reentrant (two-segment) 
capability. HISEG should appear at the beginning of 
the source program. 



HISEG does not affect assembler operation. The code 
produced by HISEG will execute at either relocatable 
or relocatable 400000, depending on the loading 
instructions given. 

The code following HISEG looks as if it was assembled 
to start at relocatable 0. 

This pseudo-op has been replaced by TWOSEG. 
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RIM 



FORMAT 



RIM 



FUNCTION 



Specifies a format for absolute binary programs (useful 
only for PDP-6 systems) , and consists of a series of 
paired words. 



The first word of each pair is a paper-tape read 
instruction giving the memory address of the second 
word. The last pair of words is a transfer block; the 
first is an instruction obtained from the END statement 
and executed when the transfer block is read, and the 
second is a dummy word to stop the reader. 
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RIM10 



FORMAT 



RIM10 



FUNCTION 



Causes a program format in which programs are absolute, 
unblocked, and not checksummed. When the RIM10 
statement follows a LOC statement in a program, the 
assembler punches out each storage word in the object 
program, starting at the absolute address specified in 
the LOC statement. RIM10 writes an arbitary "paper 
tape"; if it is in the format given below, it can be 
read by the DECsystem-10 Read-In Mode hardware. 



IOWD n, first 

where n is the length of the program including the 
ending word transfer, and first is the first memory 
location to be occupied. The last location must 
contain a transfer instruction to begin the program, 
such as 

JRST A, GO 

For example, if a program with RIM10 output has its 
first location at START and its last location at 
FINISH, you can write 

IOWD FINISH-START+1 > START 



NOTE 

If the location counter is increased but no 
binary output occurs (for example, BLOCK, LOC, 
and VAR pseudo-ops) , MACRO inserts a zero word 
into the binary output file for each location 
skipped by the location counter. 
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RIM10B 



FORMAT 



RIM10B 



FUNCTION 



If a program is assembled into absolute locations (not 
relocatable) , a RIM10B statement following the LOC 
statement at the beginning of the source program causes 
the assembler to write out the object program in RIM10B 
format. This format is designed for use with the 
DECsystem-10 Read-In Mode hardware. 

The program is punched during Pass 2, starting at the 
location specified in the LOC statement. If the first 
two statements in the program are 

LOC 1000 
RIM10B 

MACRO assembles the program with absolute addresses 
starting at 1000 and punches the program in RIM10B 
format, also starting at location 1000. You can reset 
the location counter during assembly, but only one 
RIM10B statement is needed to punch the entire program. 

In RIM10B format, the assembler punches the RIM10B 
Loader, followed by the program in 17-word (or less) 
data blocks, each block separated by blank tape. The 
assembler inserts an I/O transfer word (IOWD) preceding 
each data block, and also inserts a 36-bit checksum 
following each data block. The word count in the IOWD 
counts only the data words in the block, and the 
checksum is the 36-bit added checksum of the IOWD and 
the data words. 



Data blocks can contain less than 17 words. 



If the 



assembler assigns a nonconsecutive location, the 
current data block is terminated, and an IOWD 
containing the next location is inserted, starting a 
new data block. 

The transfer block consists of two words. The first 
word of the transfer block is an instruction obtained 
from the END statement. This first word is executed 
when the transfer block is read. The second word is a 
dummy word to stop the reader. 
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APPENDIX F 
STORAGE ALLOCATION 



MACRO allocates storage in two directions: 

1. User symbols and macronames are entered in the symbol tables. 

2. Macros and literals are entered in free space. 

A symbol table entry is two words long. The first word is the symbol 
name in SIXBIT. The second word has flags in the left half, and 
either the value or a pointer in the right half. The flags indicate 
symbol type and attributes. 

The following list shows how symbols and values are stored. 



Type 

18-bit symbol 

36-bit symbol 

(includes OPDEFs 

and negative numbers) 

EXTERNAL symbol 



Polish symbol 



How Stored 

Value in right half of second word. 

Value in free storage with a pointer in 
symbol table. 



Pointer in symbol table to a 2-word block in 
free storage. The first word is the value 
that is the last reference in a chain of 
references to the symbol; the second word is 
the symbol name in SIXBIT. 



The symbol table entry points to a 
block : 



2-word 



word 1: 

word 2: negative number , , address 

Word 1 is the relocation word and is always 
zero. Word 2 gives the address of a Polish 
stack in free storage. The Polish stack is 
of the form: 



word 1 

word 2 

word 3 

word 4 

word 5 

word 6 





opcode 

relocation constant 

value 

relocation constant 

value 
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Words 3 and 4 designate an operand. If the 
operator is binary, words 5 and 6 designate 
the second operand; if the operator is 
unary, the stack contains only four words. 

If an operand is EXTERNAL, its two words (3 
and 4, or 5 and 6) are: 

word i: pointer to EXTERNAL symbol 
word i+1: 

If an operand is itself a Polish symbol, its 
two words are: 

word i: Polish pointer 
word i+1: 



Inter-PSECT reference 



Polish stack containing: 



word 1 

word 2 

word 3 

word 4 

word 5 

word 6 




15 
-2 

referenced PSECT index 
relocation constant 
address 



Synonym operator 
(SYN argument) 



SIXBIT operator name in free storage with a 
pointer in the symbol table. 



Macroname 



Value in free storage with a pointer to the 
text string in symbol table. 



The text string is stored in a 4-word block 
of the form: 



word 1: link to next block (0 if 
last),, two characters 



word 2 
word 3 
word 4 



five characters 
five characters 
five characters 



However, the first such block is 
special : 



word 1: 
word 2 



word 3 
word 4: 



link to next block,, link 

to last block 

pointer to default 

arg.,, number of args 

expected + reference count 

five characters 

five characters 



The number of args expected is the number of 
dummy-arguments in the macro definition. 

The reference count is incremented when the 
macro is called and decremented when the 
macro is exited. When this count goes to 
zero, the macro is removed from free space. 
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Macro arguments Stored in the same linked block, but not- in 

the symbol table. Repeats (two or more 
times) are also stored in the same way. The 
text blocks are removed when the macro exits 
or the repeat exits, since the reference 
count has gone to zero. 

The addresses of the actual argument blocks 
are stored in a pushdown stack in order of 
generation. 

Default arguments are stored in the same way, 
except that the list is in free core. The 
pointer to the default arg list is stored in 
the left half of the second word of the first 
block of the macro definition. 

Macros The macrobody is stored as is, except that 

dummy-arguments are replaced by special 
symbols. 

ASCII 177 (RUBOUT) signals that the next 
character is a special character, as follows: 

001 ;end of macro 

002 ;end of dummy symbol 

003 ;end of REPEAT 

004 ;end of IRP or IRPC 

005 ; RUBOUT 

If the character is more than 5 and less than 
100, it is illegal. 

If the character is greater than or equal to 
100, it is a dummy symbol; the value of the 
character is ANDed with 37 to get the dummy 
symbol number, and the corresponding pointer 
retrieved from the stack of actual arguments. 

If the symbol was not specified (that is, has 
no pointer), and if the 40 bit is on, this 
symbol requires a created symbol, and one is 
created; otherwise the argument is ignored. 

NOTE 

Verbose macros can use too much 
storage space. 
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Literals 



Four-word block for each word generated 



word 1 

word 2 

word 3 

word 4 



form word 

relocation bits 

code 

pointer to next block 



Form word is the word used for listing. 
This word is not checked when comparing 
literals, so that different forms 
producing the same code are classed as 
equal . 



Relocation bits are 0, 
pointers. 



1, or EXTERNAL 



Pointer is the address of the zero 
of the next block. 



word 



NOTE 

Long literals slow assembly and 
use storage; they should be 
written as subroutines or inline 
code . 
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Number pseudo-ops (Cont.) 
EXP, 3-20 
OCT, 3-44 
RADIX, 3-55 
RADIX50, 3-56 
SQUOZE, 3-66 
Z, 3-83 



/O, 7-3 
"0, B-3 
OCT, 3-44 
.OKOVL, 3-16 
One's complement, 2-14 
Op-code table, 2-9 
Opcode table, 6-4 
OPDEF (pseudo-op) , 3-45 
OPDEF operator, 4-2 
OPDEF storage, F-l 
Operand, 4-2, 4-3, 4-4 
Operation, 

hierarchy, 2-14 
Operator, 4-2, 4-3, 4-4 
Operator , 

arithmetic, 2-13 

logical, 2-13 
OR, 2-13 
.ORG, 3-46 
Output, 

assembler , 6-1 
Overflow, 

arithmetic, 3-16 



Pound-s 
PRGEND, 
Primary 

- 4-4 
PRINTX, 
Program 

singl 

two-s 
Program 
Program 

binar 
Program 
Program 
Program 
Program 
.PSECT, 
PSECTs, 

progr 
Pseudo- 

forma 
Pseudo- 
Pseudo- 

compa 
PURGE , 



ign (#) , 6-2, B-5 
3-51 
instruction format, 

3-52 

e-segment, 9-1 
egment, 9-2 

compilation, 7-1 

file, 
y, 6-5 

listing file, 6-1 

name, 3-73 

segmentation, 9-1 

with PSECTs, 9-3 

3-53 

am with, 9-3 

op, 

t, 3-1 

op operator, 4-2 

ops, 

tibility, E-l 

3-54 



/Q, 7-3 

Querying bit pattern, 2-6 

Quotation marks (" ) , 

double, B-5 
Quotation marks ('), 

single, B-5 
Quoting characters in 
argument, 5-4 



/P, 7-3 

P22, 3-21 

PAGE, 3-47 

Parentheses, B-6 

Pass 1, 3-17, 4-3 

Pass 2, 3-17, 4-3 

Pass control pseudo-ops, 

END, 3-17 

PASS2, 3-48 

PRGEND, 3-51 
PASS2 (pseudo-op) , 3-48 
Passed argument, 5-1, 5-2 
Percent-sign (%) , B-6 
PHASE, 3-49, 6-2 
Plus sign (+) , B-4 
POINT, 3-50 
Pointer , 

byte, 3-50 
Pol code, 6-4 
Polish expression, 2-14 
Polish symbol storage, F-l 
Pound-sign (##) , 

double, B-5 



Radix, 2-2 

RADIX (pseudo-op) , 3-55 

RADIX50, 3-56 

RADIX50 character codes, 

A-l 
Register , 

index, 4-4 
RELOC, 3-57 
Relocatable address, 3-46, 

3-57 
Relocatable code, 1-3 
Relocatable expression, 

2-15 
Relocatable symbol, 2-12 
REMARK (pseudo-op) , 3-59 
Repeat, 

indefinite, 3-30, 3-31, 

3-67, 5-10 
REPEAT (pseudo-op) , 3-60 
.REQUEST, 3-61 
.REQUIRE, 3-62 
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INDEX (Cont.) 



RIM, E-3 
RIM10, E-4 
RIM10B, E-5 



/S, 7-4 
SALL, 3-63 
SEARCH, 3-64 
Segmentation, 

program, 9-1 
Semicolon ( ; ) , B-3 
Semicolon ( ; ; ) , 

double, B-3 
Sen code, 6-4 
Sex code, 6-4 
SFCOND, 3-16 
Shifting , 

binary, 2-6 

underscore, 2-6 
Sin code, 6-4 
Single quotation marks ('), 

B-5 
Single-character error code, 

8-3 
Single-segment program, 9-1 
SIXBIT (pseudo-op) , 3-65 
SIXBIT character codes, A-l 
Slash (/) , B-4 
Spd code, 6-4 
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Storage , 

symbol, F-l 
Storage allocation, F-l 
Storage pseudo-ops, 

ARRAY, 3-2 

BLOCK, 3-8, 6-2 

BYTE, 3-9 
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